Matplotlib多折线图如何在状态栏显示悬停折线图例及对应数值
Matplotlib多折线图自定义状态栏实现方案
核心逻辑说明
默认的Axes.format_coord只能拿到鼠标当前的x/y轴坐标,没法直接关联到鼠标压在哪个折线上,这也是你之前单独调整format_coord达不到预期效果的原因。要实现带折线信息的状态栏,必须结合鼠标移动事件,实时判断当前悬停的目标折线,再动态拼出要显示的内容。
实现步骤
- 存储所有折线对象与对应图例:Matplotlib里每个折线条目(
Line2D对象)自带label属性,就是之前传给plot的图例文本,遍历ax.lines就能拿到所有数据系列 - 绑定鼠标移动事件:用
fig.canvas.mpl_connect绑定motion_notify_event,只要鼠标在画布上移动就触发判断- 先判断鼠标是不是在坐标轴区域里,如果不在就切回默认的坐标显示格式
- 遍历所有折线,用
Line2D自带的contains方法判断鼠标位置是不是落在折线的可识别范围内,找出当前真正悬停的目标折线 - 找到目标折线后,根据鼠标当前的x坐标,线性插值算出这个折线在对应位置的y值
- 动态修改
ax.format_coord的返回内容,把x坐标、折线名、对应数值拼进去,Matplotlib会自动把这个内容显示到底部状态栏里
可运行参考代码
import matplotlib.pyplot as plt import numpy as np # 生成测试数据 x = np.linspace(0, 10, 100) y1 = np.sin(x) y2 = np.sin(x + 0.5) y3 = np.sin(x + 1.0) fig, ax = plt.subplots(figsize=(8,4)) # 绘制同色系折线,绑定对应图例标签 line1, = ax.plot(x, y1, color='#1f77b4', label='Line A (phase 0)') line2, = ax.plot(x, y2, color='#1f77b4', label='Line B (phase 0.5)') line3, = ax.plot(x, y3, color='#1f77b4', label='Line C (phase 1.0)') ax.legend() def update_statusbar(event): # 鼠标未进入坐标轴区域时,使用默认坐标显示 if event.inaxes != ax: ax.format_coord = lambda x, y: f'x={x:.2f}, y={y:.2f}' return hovered_line = None # 交互阈值(单位:像素),可根据图表缩放级别调整 interaction_threshold = 5 for line in ax.lines: # 判断鼠标位置是否在折线的交互范围内 is_hovered, _ = line.contains(event, threshold=interaction_threshold) if is_hovered: hovered_line = line break # 未悬停到任何折线时,仅显示基础坐标 if hovered_line is None: ax.format_coord = lambda x, y: f'x={x:.2f}, y={y:.2f}' return # 计算悬停折线在当前x位置的对应y值 current_x = event.xdata current_y = np.interp(current_x, hovered_line.get_xdata(), hovered_line.get_ydata()) # 自定义状态栏显示格式 ax.format_coord = lambda x, y: f'x={current_x:.2f} | Series: {hovered_line.get_label()} | Value: {current_y:.3f}' # 绑定鼠标移动事件 fig.canvas.mpl_connect('motion_notify_event', update_statusbar) plt.show()
优化提示
- 如果几条折线离得特别近,都在交互阈值范围内,可以改下判断逻辑,分别算每条线到鼠标的垂直距离,选最近的那条当悬停目标,避免识别错系列
- 交互阈值(单位是像素)可以根据你的线条粗细、图表缩放级别调整,太大会误判,太小又难触发
- 整个逻辑全靠Matplotlib官方提供的接口实现,不用修改底层组件,跨版本兼容性比较好
- 如果在Jupyter环境下使用,需要确保交互后端是支持事件回调的(比如
%matplotlib notebook或者%matplotlib widget),否则状态栏更新不会生效
内容的提问来源于stack exchange,提问作者Pedantic
相关产品推荐
相关产品推荐

