matplotlib.axes.Axes.barbs#

Axes.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）在气象学中传统上用于绘制风速和风向观测值，但在技术上可用于绘制任何二维矢量量。与通过箭头长度表示矢量大小的箭头图不同，风羽图通过在不同量级增量上放置斜线或三角形，提供了关于矢量大小更定量的描述，如下图所示。

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

最大的增量用三角形（或“旗帜”）表示。其次是全长线（风羽）。最小的增量是半长线。当然，半长线最多只有一根。如果量级较小且只需要一根半长线而无需全长线或三角形，则该半长线会从风羽末端偏移，以便与带有单根全长线的风羽区分开。根据 50、10 和 5 的标准增量，上图所示风羽的标称量级为 65。

另请参阅 https://en.wikipedia.org/wiki/Wind_barb。

参数:

X, Y一维或二维类数组，可选

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

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

如果 X 和 Y 是一维的，但 U 和 V 是二维的，则使用 X, Y = np.meshgrid(X, Y) 将 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`	color 或 color 列表或 'face'
`facecolor` 或 `facecolors` 或 `fc`	color 或 color 列表
`figure`	`Figure` 或 `SubFigure`
`gid`	str
`hatch`	{'/', '\', '\|', '-', '+', 'x', 'o', 'O', '.', '*'}
`hatch_linewidth`	未知
`hatchcolor`	color 或 color 列表或 'edge'
`in_layout`	布尔值
`joinstyle`	`JoinStyle` 或 {'miter', 'round', 'bevel'}
`label`	object
`linestyle` 或 `dashes` 或 `linestyles` 或 `ls`	{'-', '--', '-.', ':', '', ...} 或 (offset, on-off-seq) 或其列表
`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`	浮点数

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

风羽

barbs(X, Y, U, V)

matplotlib.axes.Axes.barbs#

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

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