matplotlib.quiver.QuiverKey

class matplotlib.quiver.QuiverKey(Q, X, Y, U, label, *, angle=0, coordinates='axes', color=None, labelsep=0.1, labelpos='N', labelcolor=None, fontproperties=None, zorder=None, **kwargs)

基类：Artist

用于箭图比例尺键的带标签箭头。

为quiver图添加图例。

键的位置取决于 *X*、*Y*、*coordinates* 和 *labelpos*。如果 *labelpos* 为 'N' 或 'S'，则 *X*、*Y* 指定键箭头的中间位置。如果 *labelpos* 为 'E'，则 *X*、*Y* 指定箭头头部位置；如果 *labelpos* 为 'W'，则 *X*、*Y* 指定箭头尾部位置。在后两种情况下，*X*、*Y* 位于箭头+标签键对象的中间某处。

参数:

QQuiver

调用 quiver() 返回的 Quiver 对象。

X, Yfloat

图例的位置。

Ufloat

图例的长度。

labelstr

图例标签（例如，图例的长度和单位）。

anglefloat, 默认值: 0

图例箭头的角度，从水平轴逆时针方向测量的度数。

coordinates{'axes', 'figure', 'data', 'inches'}, 默认值: 'axes'

*X*、*Y* 的坐标系和单位：'axes' 和 'figure' 是归一化坐标系，(0, 0) 在左下角，(1, 1) 在右上角；'data' 是轴数据坐标（用于箭图中向量的位置）；'inches' 是图中以英寸为单位的位置，(0, 0) 在左下角。

color颜色

覆盖来自Q的填充颜色和边缘颜色。

labelpos{'N', 'S', 'E', 'W'}

标签位置，分别位于箭头的上方、下方、右侧、左侧。

labelsepfloat, 默认值: 0.1

箭头和标签之间的距离（以英寸为单位）。

labelcolor颜色, 默认值: rcParams["text.color"] (默认值: 'black')

标签颜色。

fontpropertiesdict, 可选

一个字典，包含 FontProperties 初始化器接受的关键字参数：*family*、*style*、*variant*、*size*、*weight*。

zorderfloat

图例的Z轴顺序。默认值比Q高0.1。

**kwargs

任何额外的关键字参数都用于覆盖来自Q的矢量属性。

contains(mouseevent)

测试艺术家是否包含鼠标事件。

参数:

mouseeventMouseEvent

返回:

contains布尔值

是否有任何值在半径范围内。

details字典

一个艺术家特定的字典，包含事件上下文的详细信息，例如哪些点包含在选择半径内。有关详细信息，请参阅各个 Artist 子类。

draw(renderer)

使用给定的渲染器绘制 Artist（及其子对象）。

如果艺术家不可见 (Artist.get_visible 返回 False)，则此操作无效。

参数:

rendererRendererBase 子类.

备注

此方法在 Artist 子类中被覆盖。

halign = {'E': 'left', 'N': 'center', 'S': 'center', 'W': 'right'}

property labelsep

pivot = {'E': 'tip', 'N': 'middle', 'S': 'middle', 'W': 'tail'}

set(*, agg_filter=<UNSET>, alpha=<UNSET>, animated=<UNSET>, clip_box=<UNSET>, clip_on=<UNSET>, clip_path=<UNSET>, gid=<UNSET>, in_layout=<UNSET>, label=<UNSET>, mouseover=<UNSET>, path_effects=<UNSET>, picker=<UNSET>, rasterized=<UNSET>, sketch_params=<UNSET>, snap=<UNSET>, transform=<UNSET>, url=<UNSET>, visible=<UNSET>, zorder=<UNSET>)

一次性设置多个属性。

支持的属性包括：

属性	描述
agg_filter	一个过滤函数，它接受一个 (m, n, 3) 浮点数组和一个 dpi 值，并返回一个 (m, n, 3) 数组以及图像左下角的两个偏移量
alpha	浮点数或 None
animated	布尔值
clip_box	BboxBase 或 None
clip_on	布尔值
clip_path	Patch 或 (Path, Transform) 或 None
figure	未知
gid	str
in_layout	布尔值
label	object
mouseover	布尔值
path_effects	list of AbstractPathEffect
picker	None 或 布尔值 或 浮点数 或 可调用对象
rasterized	布尔值
sketch_params	(scale: 浮点数, length: 浮点数, randomness: 浮点数)
snap	布尔值或 None
transform	变换
url	str
visible	布尔值
zorder	浮点数

set_figure(fig)

设置艺术家所属的 Figure 或 SubFigure 实例。

参数:

figFigure 或 SubFigure

valign = {'E': 'center', 'N': 'bottom', 'S': 'top', 'W': 'center'}

使用 matplotlib.quiver.QuiverKey 的示例

高级颤动图和颤动图键函数

高级颤动图和颤动图键函数