Python matplotlib SpanSelector用法及代码示例

本文简要介绍 python 语言中 matplotlib.widgets.SpanSelector 的用法。

用法

class matplotlib.widgets.SpanSelector(ax, onselect, direction, *, minspan=0, useblit=False, props=None, onmove_callback=None, interactive=False, button=None, handle_props=None, grab_range=10, state_modifier_keys=None, drag_from_anywhere=False, ignore_event_outside=False, snap_values=None)

基础：_SelectorWidget

在单个轴上直观地选择最小/最大范围并使用这些值调用函数。

为保证选择器保持响应，请保留对它的引用。

为了关闭 SpanSelector，请将 span_selector.active 设置为 False。要重新打开它，请将其设置为 True。

在选择之外的相同坐标处触发的按下和释放事件将清除选择器，但 ignore_event_outside=True 除外。

参数：

ax Axes

onselect 可使用签名func(min: float, max: float)调用

在释放事件和创建、更改或删除选择后调用的回调函数。

direction {"horizontal"，"vertical"}

绘制跨度选择器的方向。

minspan 浮点数，默认值：0

如果选择小于或等于 minspan ，则选择被删除(当已经存在时)或取消。

useblit 布尔值，默认值：假

如果为 True，则使用 backend-dependent blitting 函数以加快画布更新速度。有关详细信息，请参阅教程使用位图传输加快渲染速度。

props 字典，默认：{'facecolor'：'red', 'alpha'：0.5}

Patch 属性的字典。

onmove_callback 可使用签名 func(min: float, max: float) 调用，可选

在选择跨度时在鼠标移动时调用。

interactive 布尔值，默认值：假

是否绘制一组允许在绘制后与小部件交互的句柄。

button MouseButton 或 MouseButton 列表，默认值：所有按钮

激活跨度选择器的鼠标按钮。

handle_props 字典，默认值：无

跨度边的手柄线的属性。仅在 interactive 为 True 时使用。有关有效属性，请参阅 Line2D 。

grab_range 浮点数，默认值：10

可以激活交互式工具手柄的距离(以像素为单位)。

state_modifier_keys 字典，可选

影响小部件行为的键盘修饰符。值修改了默认值，它们是：

• "clear"：清除当前形状，默认："escape"。

drag_from_anywhere 布尔值，默认值：假

如果 True ，则可以通过单击其范围内的任意位置来移动小部件。

ignore_event_outside 布尔值，默认值：假

如果 True ，在跨度选择器之外触发的事件将被忽略。

snap_values 一维数组，可选

将选择器边捕捉到给定值。

例子

>>> import matplotlib.pyplot as plt
>>> import matplotlib.widgets as mwidgets
>>> fig, ax = plt.subplots()
>>> ax.plot([1, 2, 3], [10, 50, 100])
>>> def onselect(vmin, vmax):
...     print(vmin, vmax)
>>> span = mwidgets.SpanSelector(ax, onselect, 'horizontal',
...                              props=dict(facecolor='blue', alpha=0.5))
>>> fig.show()

另请参阅：跨度选择器