matplotlib.axes.Axes.barbs#

Axes.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。

传统上，风羽在气象学中用于绘制风速和风向观测，但技术上可用于绘制任何二维矢量量。与通过箭头长度表示矢量大小的箭头不同，风羽通过斜线或三角形表示不同量级的增量，从而提供关于矢量大小的更多定量信息，如下所示:

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

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

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

参数:

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

箭头位置的 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, V1D 或 2D 数组类

箭杆的 x 和 y 分量。

C1D 或 2D 数组类，可选

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

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

长度浮点数，默认值：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倒刺

其他参数:

数据可索引对象，可选

如果提供，所有参数也接受一个字符串 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: float, vmax: float)
`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`	float
`光栅化`	布尔
`sizes`	`numpy.ndarray` 或 None
`sketch_params`	(scale: float, length: float, randomness: float)
`snap`	布尔值或无
`transform`	`Transform`
`url`	str
`urls`	list of str or None
`verts`	类似数组的列表
`verts_and_codes`	未知
`可见`	布尔
`zorder`	float

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

风羽

Wind barbs

barbs(X, Y, U, V)

matplotlib.axes.Axes.barbs#

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

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