matplotlib.quiver.Barbs

class matplotlib.quiver.Barbs(ax, *args, pivot='tip', length=7, barbcolor=None, flagcolor=None, sizes=None, fill_empty=False, barb_increments=None, rounding=True, flip_barb=False, **kwargs)

基类：PolyCollection

用于风羽的专用 PolyCollection。

唯一的API方法是 set_UVC()，它可以用来改变箭头的大小、方向和颜色。位置的改变使用 set_offsets() 集合方法。可能这个方法在动画中会有用。

有一个内部函数 _find_tails() ，它根据向量的大小精确地找出应该放在箭尾上的内容。然后使用 _make_barbs() 根据这些信息找到表示箭尾的多边形的顶点。

构造函数接受一个必需参数，一个 Axes 实例，随后是以下 pyplot 接口文档中描述的 args 和 kwargs：

绘制风羽的二维场。

调用签名:

barbs([X, Y], U, V, [C], /, **kwargs)

其中 X, Y 定义了箭头的位置，U, V 定义了箭头的方向，而 C 可选地设置了颜色。

参数 X, Y, U, V, C 仅支持位置参数，可以是1D或2D。U, V, C 可以是掩码数组，但目前不支持掩码的 X, Y。

传统上，风羽在气象学中用于绘制风速和风向观测，但技术上可以用于绘制任何二维矢量量。与通过箭头长度表示矢量大小的箭头不同，风羽通过斜线或三角形表示矢量大小的各种增量，如下所示的示意图:

:                   /\    \
:                  /  \    \
:                 /    \    \    \
:                /      \    \    \
:               ------------------------------

最大的增量由一个三角形（或“旗”）给出。之后是整条线（羽状线）。最小的增量是半条线。当然，最多只有一条半线。如果量级较小，只需要一条半线和没有整条线或三角形，半线会从羽状线的末端偏移，以便于与只有一条整线的羽状线区分开来。上图所示的羽状线的量级名义上是65，使用标准的增量50、10和5。

另见 https://en.wikipedia.org/wiki/Wind_barb。

参数:

X, Y1D 或 2D 数组类，可选

箭头位置的 x 和 y 坐标。关于箭头如何绘制到 x, y 位置，请参见 pivot。

如果没有给出，它们将根据 U 和 V 的维度生成一个均匀的整数网格。

如果 X 和 Y 是 1D 但 U 和 V 是 2D，X 和 Y 将使用 X, Y = np.meshgrid(X, Y) 扩展为 2D。在这种情况下，len(X) 和 len(Y) 必须匹配 U 和 V 的列和行维度。

U, V1D 或 2D 数组类

箭杆的 x 和 y 分量。

C1D 或 2D 数组类，可选

通过 norm 和 cmap 进行颜色映射来定义箭头颜色的数值数据。

这不支持显式颜色。如果你想直接设置颜色，请使用 barbcolor 代替。

长度float, 默认值: 7

倒刺的长度，以点为单位；倒刺的其他部分根据此长度进行缩放。

枢轴{'tip', 'middle'} 或 float, 默认: 'tip'

箭头固定在 X, Y 网格上的部分。羽状物围绕这一点旋转。这也可以是一个数字，表示羽状物的起点从网格点偏移多少个点。

barbcolor : color 或颜色序列颜色或颜色序列

除了旗帜之外，所有部分的颜色的颜色。这个参数类似于多边形的 edgecolor 参数，可以替代使用。然而，这个参数将覆盖 facecolor。

flagcolor : color 或颜色序列颜色或颜色序列

任何旗帜在鱼竿上的颜色。此参数类似于多边形的 facecolor 参数，可以替代使用。然而，此参数将覆盖 facecolor。如果未设置此参数（且 C 也未设置），则 flagcolor 将设置为与 barbcolor 匹配，以便鱼竿具有统一的颜色。如果已设置 C，则 flagcolor 无效。

尺寸dict, 可选

一个系数字典，指定给定特征与箭杆长度的比率。只有那些希望覆盖的值才需要包含在内。这些特征包括：

• 'spacing' - 特征之间的间距（旗帜、全/半倒钩）

• 'height' - 高度（从旗杆到顶部的距离）

• 'width' - 旗帜的宽度，是完整羽状条带宽度的两倍

• 'emptybarb' - 用于低量级的圆的半径

fill_emptybool, 默认值: False

是否应使用旗帜颜色填充绘制的空心倒刺（圆圈）。如果不填充，中心将是透明的。

舍入bool, 默认值: True

在分配箭头组件时，是否应将矢量大小四舍五入。如果为 True，则大小会四舍五入到最近的半箭头增量倍数。如果为 False，则大小仅截断到下一个最低倍数。

barb_incrementsdict, 可选

一个增量字典，指定与箭头不同部分关联的值。只需要包含希望覆盖的那些值。

• 'half' - 半栏（默认值为5）

• 'full' - 完整箭头（默认值为10）

• 'flag' - 标志（默认值为50）

flip_barb布尔值或布尔值数组，默认值：False

线条和旗帜是否应指向与正常相反的方向。正常行为是让倒钩和线条指向右侧（源自风向标在北半球指向低压区的特性）。

单个值应用于所有箭头。可以通过传递与 U 和 V 大小相同的布尔数组来翻转单个箭头。

返回:

barbs倒钩

其他参数:

数据可索引对象，可选

DATA_PARAMETER_PLACEHOLDER

**kwargs

可以通过使用 PolyCollection 关键字参数进一步自定义倒刺：

属性	描述
agg_filter	一个过滤函数，它接受一个 (m, n, 3) 浮点数组和一个 dpi 值，并返回一个 (m, n, 3) 数组和两个从图像左下角开始的偏移量
alpha	类数组或标量或无
animated	布尔
抗锯齿 或 aa 或 antialiaseds	布尔值或布尔值列表
数组	类似数组或无
capstyle	CapStyle 或 {'butt', 'projecting', 'round'}
clim	(vmin: 浮点数, vmax: 浮点数)
clip_box	BboxBase 或 None
clip_on	布尔
clip_path	补丁或（路径，变换）或无
cmap	Colormap 或 str 或 None
颜色	color 或 RGBA 元组列表
edgecolor 或 ec 或 edgecolors	color 或 color 列表 或 'face'
facecolor 或 facecolors 或 fc	color 或 color 列表
figure	Figure 或 SubFigure
gid	str
hatch	{'/', '', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
in_layout	布尔
joinstyle	JoinStyle 或 {'miter', 'round', 'bevel'}
标签	对象
linestyle 或虚线或线型或 ls	str 或 tuple 或其列表
linewidth 或 linewidths 或 lw	浮点数或浮点数列表
鼠标悬停	布尔
norm	Normalize 或 str 或 None
offset_transform 或 transOffset	Transform
偏移量	(N, 2) 或 (2,) 数组类
path_effects	AbstractPathEffect 的列表
路径	类数组列表
picker	None 或 bool 或 float 或 callable
pickradius	浮动
光栅化	布尔
sizes	numpy.ndarray 或 None
sketch_params	(scale: float, length: float, randomness: float)
snap	布尔值或无
transform	Transform
url	str
urls	list of str 或 None
verts	类数组列表
verts_and_codes	未知
可见	布尔
zorder	浮动

set(*, UVC=<UNSET>, agg_filter=<UNSET>, alpha=<UNSET>, animated=<UNSET>, antialiased=<UNSET>, array=<UNSET>, capstyle=<UNSET>, clim=<UNSET>, clip_box=<UNSET>, clip_on=<UNSET>, clip_path=<UNSET>, cmap=<UNSET>, color=<UNSET>, edgecolor=<UNSET>, facecolor=<UNSET>, gid=<UNSET>, hatch=<UNSET>, in_layout=<UNSET>, joinstyle=<UNSET>, label=<UNSET>, linestyle=<UNSET>, linewidth=<UNSET>, mouseover=<UNSET>, norm=<UNSET>, offset_transform=<UNSET>, offsets=<UNSET>, path_effects=<UNSET>, paths=<UNSET>, picker=<UNSET>, pickradius=<UNSET>, rasterized=<UNSET>, sizes=<UNSET>, sketch_params=<UNSET>, snap=<UNSET>, transform=<UNSET>, url=<UNSET>, urls=<UNSET>, verts=<UNSET>, verts_and_codes=<UNSET>, visible=<UNSET>, zorder=<UNSET>)

一次性设置多个属性。

支持的属性有

属性	描述
UVC	未知
agg_filter	一个过滤函数，它接受一个 (m, n, 3) 浮点数组和一个 dpi 值，并返回一个 (m, n, 3) 数组和两个从图像左下角开始的偏移量
alpha	类数组或标量或无
animated	布尔
抗锯齿 或 aa 或 antialiaseds	布尔值或布尔值列表
数组	类似数组或无
capstyle	CapStyle 或 {'butt', 'projecting', 'round'}
clim	(vmin: 浮点数, vmax: 浮点数)
clip_box	BboxBase 或 None
clip_on	布尔
clip_path	补丁或（路径，变换）或无
cmap	Colormap 或 str 或 None
颜色	color 或 RGBA 元组列表
edgecolor 或 ec 或 edgecolors	color 或 color 列表 或 'face'
facecolor 或 facecolors 或 fc	color 或 color 列表
figure	Figure 或 SubFigure
gid	str
hatch	{'/', '', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
in_layout	布尔
joinstyle	JoinStyle 或 {'miter', 'round', 'bevel'}
标签	对象
linestyle 或虚线或线型或 ls	str 或 tuple 或其列表
linewidth 或 linewidths 或 lw	浮点数或浮点数列表
鼠标悬停	布尔
norm	Normalize 或 str 或 None
offset_transform 或 transOffset	Transform
偏移量	浮点数对的序列
path_effects	AbstractPathEffect 的列表
路径	类数组列表
picker	None 或 bool 或 float 或 callable
pickradius	浮动
光栅化	布尔
sizes	numpy.ndarray 或 None
sketch_params	(scale: float, length: float, randomness: float)
snap	布尔值或无
transform	Transform
url	str
urls	list of str 或 None
verts	类数组列表
verts_and_codes	未知
可见	布尔
zorder	浮动

set_UVC(U, V, C=None)

set_offsets(xy)

设置箭头多边形的偏移量。这将保存传入的偏移量，并根据现有的U/V数据适当地屏蔽它们。

参数:

xy浮点数对的序列