matplotlib.axes.Axes.barbs#

Axes.barbs(*args, data=None, **kwargs)[source]#

绘制 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可索引对象，可选

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

**kwargs

倒钩可以进一步使用 PolyCollection 关键字参数进行自定义

属性	描述
`agg_filter`	一个过滤函数，它接受一个 (m, n, 3) 浮点数组和一个 dpi 值，并返回一个 (m, n, 3) 数组以及图像左下角的两个偏移量
`alpha`	类数组或浮点数或 None
`animated`	布尔值
`antialiased` or `aa` or `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` or `ec` or `edgecolors`	颜色或颜色列表或 'face'
`facecolor` or `facecolors` or `fc`	颜色或颜色列表
`figure`	`Figure` or `SubFigure`
`gid`	字符串
`hatch`	{'/', '\', '\|', '-', '+', 'x', 'o', 'O', '.', '*'}
`hatch_linewidth`	未知
`in_layout`	布尔值
`joinstyle`	`JoinStyle` 或 {'miter', 'round', 'bevel'}
`label`	对象
`linestyle` or `dashes` or `linestyles` or `ls`	字符串或元组或其列表
`linewidth` or `linewidths` or `lw`	浮点数或浮点数列表
`mouseover`	布尔值
`norm`	`Normalize` 或字符串或 None
`offset_transform` or `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`	浮点数

使用 `matplotlib.axes.Axes.barbs` 的示例#

风羽

barbs(X, Y, U, V)

matplotlib.axes.Axes.barbs#

使用 matplotlib.axes.Axes.barbs 的示例#

使用 `matplotlib.axes.Axes.barbs` 的示例#