Python中的 Matplotlib.artist.Artist.get_picker()

matplotlib.artist.Artist.get_picker() 是 Matplotlib 中的一个功能，用于获取对象的鼠标点击范围，可以方便地进行鼠标事件处理。

一、使用场景

当我们需要在图像上添加交互时，可以使用 get_picker() 来获取鼠标点击范围，比如：

• 需要在图像上添加点击事件，实现点击后某项动作的效果。
• 需要在图像上添加鼠标移动事件，实现鼠标移动到某个区域时实时生成提示或信息等。

二、使用方法

get_picker() 方法有两种常见用法：

1. 在创建图像时，直接添加鼠标点击范围

例如在绘制散点图时，可以通过如下的代码设置点的大小，并在 s 参数中添加 get_picker()，使得每个点的点击范围都是 20：

fig, ax = plt.subplots()
scatter = ax.scatter(x, y, s=20, picker=True)
...
def on_pick(event):
    ...
scatter.figure.canvas.mpl_connect('pick_event', on_pick)

在这里， picker=True 会自动调用 get_picker() 方法，来获取点的点击范围。

2. 通过重写 get_picker() 方法自定义鼠标点击范围

在某些情况下，我们需要根据当前的需求自定义鼠标点击范围，这时候可以通过重写 get_picker() 方法来实现。

例如，在绘制常数线图时，我们想让鼠标只能点击线上的点才能触发事件。

class StepLine2D(Line2D):
    def __init__(self, *args, **kwargs):
        Line2D.__init__(self, *args, **kwargs)

    def get_picker(self):
        """
        Override hover, return the indices of the point the mouse is over.
        """
        x_distance = np.abs(np.subtract.outer(self.get_xdata(), self._picker[0]))
        y_distance = np.abs(np.subtract.outer(self.get_ydata(), self._picker[1]))
        distances = np.hypot(x_distance, y_distance)
        ind = np.where(distances == distances.min())
        if distances.min() > self._picker[2]:
            ind = (None,)
        return ind[0]

以上代码重写了 get_picker() 方法，通过计算距离来判断当前鼠标是否在距离线上点最近的范围内，若不在范围内则返回 (None,)。这样就可以实现只有鼠标在线上点上时才能触发事件。

三、相关参数

在使用 get_picker() 方法时，常用的相关参数如下：

• picker: bool or float or callable, optional, default:False

当 picker=True 时，自动调用 get_picker() 方法获取鼠标点击范围。也可以手动指定数值，即数值就是鼠标点击范围，不同的对象使用该数值时，具体含义也不同，例如：

ax.scatter(x, y, s=100, picker=5)
ax.plot(x, y, picker=0.5)
ax.text(x, y, s="clickable", picker=True)

• pickradius: scalar, optional, default:5

指定默认的鼠标点击范围，当设置了 picker=True 时生效。

四、总结

matplotlib.artist.Artist.get_picker() 在 Matplotlib 动态交互中起到了重要的作用，可以方便地进行鼠标事件处理。在默认情况下， get_picker() 会自动获取鼠标点击范围。如果需要自定义鼠标点击范围，可以重写该方法来实现。