Matplotlib中在绘图区外顶部放置PathPatch并动态适配文本宽度

针对你提出的两个需求，以下是具体实现方案：

1. 让路径宽度随文本自动适配 #

先渲染文本以获取其实际显示宽度，再以此为基准调整路径的顶点坐标，确保路径宽度与文本匹配。

2. 将标签放置在顶部轴线正上方 #

利用Matplotlib的坐标转换工具，把标签定位到绘图区域外部、顶部轴线的正上方位置。

完整实现代码 #

import matplotlib.pyplot as plt
import matplotlib.patches as mpatches
import matplotlib.path as mpath

fig, ax = plt.subplots()
ax.grid()
ax.axis('equal')

# 定义文本内容与样式
text_content = "自定义标签"
font_size = 32
# 先把文本放在顶部轴线正上方中间位置（transAxes坐标中y=1.1表示轴顶部上方10%的位置）
text_obj = ax.text(
    x=0.5, y=1.1, s=text_content, fontsize=font_size,
    ha='center', va='bottom', transform=ax.transAxes
)

# 渲染画布以获取准确的文本尺寸
fig.canvas.draw()
# 将文本的屏幕范围转换为轴的数据坐标
text_bbox = text_obj.get_window_extent().transformed(ax.transData.inverted())
text_width = text_bbox.width  # 文本在数据空间的实际宽度

# 定义基础路径模板，后续根据文本宽度调整
Path = mpath.Path
base_path_data = [
    (Path.MOVETO, (0, 0)),
    (Path.CURVE4, (0, 1.0)),
    (Path.CURVE4, (0.5, 1.0)),
    (Path.LINETO, (text_width - 0.5, 1.0)),
    (Path.CURVE4, (text_width, 1.0)),
    (Path.CURVE4, (text_width, 0)),
    (Path.CLOSEPOLY, (0, 0)),
]
codes, verts = zip(*base_path_data)

# 计算路径的y轴位置：放在文本正下方，与文本底部对齐
text_bottom_y = text_bbox.y0
path_y_offset = text_bottom_y - 1.0  # 路径高度为1，向下偏移1个单位
# 平移路径到目标位置
adjusted_verts = [(x, y + path_y_offset) for x, y in verts]
path = mpath.Path(adjusted_verts, codes)

# 创建并添加路径补丁
patch = mpatches.PathPatch(path, facecolor='r', alpha=0.5)
ax.add_patch(patch)

# 调整轴的y范围，确保标签完整显示
current_ylim = ax.get_ylim()
ax.set_ylim(current_ylim[0], text_bottom_y + 0.2)

plt.show()

核心细节说明 #

• 文本宽度获取：必须先调用fig.canvas.draw()渲染画布，才能通过get_window_extent()拿到准确的文本显示范围，再转换为轴的数据坐标得到实际宽度。
• 路径动态调整：修改路径的水平顶点坐标，让路径总长度等于文本宽度，保证两者尺寸匹配。
• 顶部定位：使用transAxes坐标快速将文本放在轴顶部中间，再通过坐标转换计算路径位置，确保路径与文本对齐，同时调整轴范围避免标签被裁切。

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