matplotlib.pyplot.barbs

matplotlib.pyplot.barbs(*args, data=None, **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 数组类，可选

barb 位置的 x 和 y 坐标。关于如何将 barbs 绘制到 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 将无效。

尺寸字典, 可选

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

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

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

• 'width' - 旗子的宽度，是全羽宽度的两倍

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

fill_emptybool, 默认: False

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

舍入bool, 默认值: True

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

barb_increments字典, 可选

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

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

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

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

flip_barbbool 或 bool 类型的数组，默认值：False

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

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

返回:

barbs倒刺

其他参数:

数据可索引对象，可选

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

**kwargs

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

属性	描述
agg_filter	一个过滤函数，它接收一个 (m, n, 3) 浮点数组和一个 dpi 值，并返回一个 (m, n, 3) 数组和两个从图像左下角开始的偏移量
alpha	类似数组或标量或无
animated	布尔值
抗锯齿 或 aa 或 antialiaseds	布尔值或布尔值列表
数组	类似数组或 None
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'}
标签	对象
线型 或虚线或线型或 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	浮动

注释

备注

这是 axes.Axes.barbs 的 pyplot 包装器。

使用 matplotlib.pyplot.barbs 的示例

风羽

Wind barbs