matplotlib.quiver.Barbs

类 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。

绘制 2D 风矢图。

调用签名

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, Y一维或二维类数组，可选

倒钩位置的 x 和 y 坐标。有关倒钩如何绘制到 x、y 位置的信息，请参阅 pivot。

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

如果X和Y是一维的，而U、V是二维的，则X、Y将使用X, Y = np.meshgrid(X, Y)扩展到二维。在这种情况下，len(X)和len(Y)必须与U和V的列和行维度匹配。

U, V一维或二维类数组

倒钩轴的 x 和 y 分量。

C一维或二维类数组，可选

通过 norm 和 cmap 进行颜色映射，定义倒钩颜色的数值数据。

这不支持显式颜色。如果要直接设置颜色，请改用 barbcolor。

length浮点型，默认值：7

倒钩的长度（以点为单位）；倒钩的其他部分以此为基准缩放。

pivot{'tip'（尖端）, 'middle'（中间）} 或 浮点型，默认值：'tip'

箭头锚定到 X、Y 网格的部分。倒钩围绕此点旋转。这也可以是一个数字，将倒钩的起点从网格点移动许多点。

barbcolor颜色 或 颜色序列

倒钩所有部分（旗标除外）的颜色。此参数类似于多边形的 edgecolor 参数，可以替代使用。但是，此参数将覆盖 facecolor。

flagcolor颜色 或 颜色序列

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

sizes字典，可选

一个系数字典，指定给定特征与倒钩长度的比率。只需包含要覆盖的值。这些特征包括：

• 'spacing' - 特征（旗标、完整/半倒钩）之间的间距

• 'height' - 旗标或完整倒钩的高度（从轴到顶部的距离）

• 'width' - 旗标的宽度，是完整倒钩宽度的两倍

• 'emptybarb' - 用于低幅度的圆的半径

fill_empty布尔型，默认值：False

绘制的空倒钩（圆形）是否应填充旗标颜色。如果未填充，中心是透明的。

rounding布尔型，默认值：True

在分配倒钩组件时，矢量大小是否应进行四舍五入。如果为 True，则大小将四舍五入到最近的半倒钩增量倍数。如果为 False，则大小将简单地截断到下一个最低倍数。

barb_increments字典，可选

一个增量字典，指定与倒钩不同部分关联的值。只需包含要覆盖的值。

• 'half' - 半倒钩（默认值：5）

• 'full' - 完整倒钩（默认值：10）

• 'flag' - 旗标（默认值：50）

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

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

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

返回:

barbsBarbs

其他参数:

data可索引对象，可选

DATA_PARAMETER_PLACEHOLDER

**kwargs

风矢可以使用PolyCollection关键字参数进一步自定义

属性	描述
agg_filter	一个过滤函数，它接受一个 (m, n, 3) 浮点数组和一个 dpi 值，并返回一个 (m, n, 3) 数组以及图像左下角的两个偏移量
alpha	类数组或浮点数或 None
animated	布尔值
antialiased 或 aa 或 antialiaseds	布尔值或布尔值列表
array	类数组或 None
capstyle	CapStyle 或 {'butt', 'projecting', 'round'}
clim	(vmin: 浮点数, vmax: 浮点数)
clip_box	BboxBase 或 None
clip_on	布尔值
clip_path	Patch 或 (Path, Transform) 或 None
cmap	Colormap 或 字符串 或 None
color	颜色 或 RGBA 元组列表
edgecolor 或 ec 或 edgecolors	颜色 或 颜色列表 或 'face'
facecolor 或 facecolors 或 fc	颜色 或 颜色列表
figure	Figure 或 SubFigure
gid	字符串
hatch	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
hatch_linewidth	未知
in_layout	布尔值
joinstyle	JoinStyle 或 {'miter', 'round', 'bevel'}
label	对象
linestyle 或 dashes 或 linestyles 或 ls	字符串或元组或其列表
linewidth 或 linewidths 或 lw	浮点数或浮点数列表
mouseover	布尔值
norm	Normalize 或 字符串 或 None
offset_transform 或 transOffset	变换
offsets	(N, 2) 或 (2,) 类数组
path_effects	AbstractPathEffect 列表
paths	类数组列表
picker	None 或 布尔值 或 浮点数 或 可调用对象
pickradius	浮点数
rasterized	布尔值
sizes	numpy.ndarray 或 None
sketch_params	(scale: 浮点数, length: 浮点数, randomness: 浮点数)
snap	布尔值或 None
transform	变换
url	字符串
字符串列表或 None	urls
verts	类数组列表
verts_and_codes	未知
visible	布尔值
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>, hatch_linewidth=<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	类数组或浮点数或 None
animated	布尔值
antialiased 或 aa 或 antialiaseds	布尔值或布尔值列表
array	类数组或 None
capstyle	CapStyle 或 {'butt', 'projecting', 'round'}
clim	(vmin: 浮点数, vmax: 浮点数)
clip_box	BboxBase 或 None
clip_on	布尔值
clip_path	Patch 或 (Path, Transform) 或 None
cmap	Colormap 或 字符串 或 None
color	颜色 或 RGBA 元组列表
edgecolor 或 ec 或 edgecolors	颜色 或 颜色列表 或 'face'
facecolor 或 facecolors 或 fc	颜色 或 颜色列表
figure	Figure 或 SubFigure
gid	字符串
hatch	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
hatch_linewidth	未知
in_layout	布尔值
joinstyle	JoinStyle 或 {'miter', 'round', 'bevel'}
label	对象
linestyle 或 dashes 或 linestyles 或 ls	字符串或元组或其列表
linewidth 或 linewidths 或 lw	浮点数或浮点数列表
mouseover	布尔值
norm	Normalize 或 字符串 或 None
offset_transform 或 transOffset	变换
offsets	浮点数对序列
path_effects	AbstractPathEffect 列表
paths	类数组列表
picker	None 或 布尔值 或 浮点数 或 可调用对象
pickradius	浮点数
rasterized	布尔值
sizes	numpy.ndarray 或 None
sketch_params	(scale: 浮点数, length: 浮点数, randomness: 浮点数)
snap	布尔值或 None
transform	变换
url	字符串
字符串列表或 None	urls
verts	类数组列表
verts_and_codes	未知
visible	布尔值
zorder	浮点数

set_UVC(U, V, C=None)

set_offsets(xy)

设置风矢多边形的偏移。这会保存传入的偏移量，并根据现有 U/V 数据对其进行适当的遮罩。

参数:

xy浮点数对序列