Matplotlib Pyplot：如何实现文本仅沿X轴方向裁剪

问题说明 #

调整绘图窗口范围放大目标区域时，文本标注会超出绘图窗口。使用clip_on=True会隐藏所有超出的文本，但仅希望裁剪X轴范围外的文本，保留Y轴方向超出的标注内容。

解决方案 #

通过自定义裁剪区域，仅限制X轴方向的文本显示范围，允许Y轴方向的文本超出绘图窗口展示。具体实现步骤如下：

1. 获取当前坐标轴对象并设置目标轴范围；
2. 创建一个覆盖目标X轴范围、Y轴范围足够大的矩形裁剪区域；
3. 为每个文本标注绑定该裁剪区域并开启裁剪功能。

完整代码示例 #

import matplotlib.pyplot as plt
from matplotlib.patches import Rectangle

x = [0,2,4,6,8,10]
y = [3,2,5,9,6,7]

fig, ax = plt.subplots()
ax.plot(x, y)

# 设置目标轴范围
ax.axis([0,5,0,10])
# 获取X轴的限制范围
x_min, x_max = ax.get_xlim()

# 创建裁剪区域：X轴匹配目标范围，Y轴设置足够大以容纳标注
clip_rect = Rectangle((x_min, -100), x_max - x_min, 200, transform=ax.transData)

# 添加文本标注并应用自定义裁剪
for xi, yi in zip(x, y):
    txt = ax.text(xi, 11, f'{yi}')
    txt.set_clip_path(clip_rect)
    txt.set_clip_on(True)

plt.show()

原理解释 #

• 默认clip_on=True会使用坐标轴的完整边界框裁剪，导致Y轴超出的文本也被隐藏；
• 自定义矩形裁剪区域仅约束X轴在目标范围内，Y轴范围设置得足够大，确保标注文本不会因Y方向超出被裁剪；
• transform=ax.transData确保裁剪区域的坐标与数据坐标一致，精准匹配绘图的X轴范围。

内容的提问来源于stack exchange，提问作者Blink