matplotlib.pyplot.barbs

matplotlib.pyplot.barbs(*args, data=None, **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。

倒刺（barbs）传统上用于气象学中，以绘制风速和风向，但技术上也可用于绘制任何二维矢量量。与通过箭头长度表示矢量大小的箭头不同，倒刺通过倾斜线或三角形表示大小的各种增量，提供更定量的矢量大小信息，如下面的示意图所示

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

最大的增量由一个三角形（或“旗帜”）表示。接下来是全长线（barbs）。最小的增量是半长线。当然，最多只有一个半长线。如果大小很小，只需要一个半长线而没有全长线或三角形，半长线会从倒刺的末端偏移，以便与只有一个全长线的倒刺区分开来。上面所示倒刺的大小通常为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可索引对象，可选

如果给定，所有参数也接受字符串 s，如果 s 是 data 中的一个键，则将其解释为 data[s]。

**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	str
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	str
字符串列表或 None	urls
verts	类数组列表
verts_and_codes	未知
visible	布尔值
zorder	浮点数

备注

注意

这是 pyplot 封装 的 axes.Axes.barbs。

使用 matplotlib.pyplot.barbs 的示例

风羽

风羽