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, **kwargs)

基类：Artist

用于作为箭袋图比例尺键的标记箭头。

向箭袋图添加一个键。

关键位置取决于 X、Y、坐标 和 labelpos。如果 labelpos 是 'N' 或 'S'，X、Y 给出关键箭头中间的位置。如果 labelpos 是 'E'，X、Y 定位箭头头部，如果 labelpos 是 'W'，X、Y 定位箭头尾部；在这两种情况下，X、Y 位于箭头+标签关键对象的中间。

参数:

Q箭筒

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

X, Y浮动

密钥的位置。

U浮动

密钥的长度。

标签str

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

角度float, 默认值: 0

键箭头的角度，从水平轴逆时针方向的角度，单位为度。

坐标{'axes', 'figure', 'data', 'inches'}，默认值：'axes'

坐标系和 X, Y 的单位：'axes' 和 'figure' 是标准化坐标系，左下角为 (0, 0)，右上角为 (1, 1)；'data' 是轴数据坐标（用于箭头图本身中矢量的位置）；'inches' 是以英寸为单位的图形位置，左下角为 (0, 0)。

颜色 : color颜色

从 Q 覆盖面和边缘颜色。

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

分别将标签放置在箭头的上方、下方、右侧、左侧。

labelsep浮点数，默认值：0.1

箭头与标签之间的距离（英寸）。

labelcolor : color, 默认值: rcParams["text.color"] (default: 'black')颜色，默认值：rcParams["text.color"]（默认值：'black'）

标签颜色。

fontpropertiesdict, 可选

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

**kwargs

任何额外的关键字参数用于覆盖从 Q 中获取的矢量属性。

contains(mouseevent)

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

参数:

mouseevent鼠标事件

返回:

包含布尔

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

详细信息dict

一个特定于艺术家的关于事件上下文细节的字典，例如哪些点包含在拾取半径内。详情请参阅各个 Artist 子类。

draw(renderer)

使用给定的渲染器绘制艺术家（及其子项）。

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

参数:

渲染器 : RendererBase 子类。RendererBase 子类。

注释

此方法在 Artist 子类中被重写。

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

property labelsep

!! 由 numpydoc 处理 !!

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	标量或无
animated	布尔
clip_box	BboxBase 或 None
clip_on	布尔
clip_path	补丁或（路径，变换）或无
figure	未知
gid	str
in_layout	布尔
标签	对象
鼠标悬停	布尔
路径效果	AbstractPathEffect 列表
picker	None 或 bool 或 float 或 callable
光栅化	布尔
sketch_params	(scale: float, length: float, randomness: float)
snap	布尔值或无
transform	Transform
url	str
可见	布尔
zorder	浮动

set_figure(fig)

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

参数:

fig : Figure 或 SubFigure图或子图

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

使用 matplotlib.quiver.QuiverKey 的示例

高级箭袋和箭袋键功能

Advanced quiver and quiverkey functions