Python matplotlib barbs用法及代码示例

本文简要介绍 python 语言中 matplotlib.pyplot.barbs 的用法。

用法

matplotlib.pyplot.barbs(*args, data=None, **kwargs)

绘制一个 2D 倒钩场。

调用签名：

barbs([X, Y], U, V, [C], **kwargs)

其中 X 、 Y 定义倒钩位置， U 、 V 定义倒钩方向， C 可选择设置颜色。

所有参数可能是一维或二维的。 U , V , C 可能是被屏蔽的数组，但目前不支持被屏蔽的 X , Y。

倒钩传统上在气象学中用作绘制风观测速度和方向的一种方式，但在技术上可用于绘制任何二维向量。与通过箭头长度给出矢量幅度的箭头相反，倒钩通过将斜线或三角形放置在幅度上的各种增量来提供有关矢量幅度的更多定量信息，如下图所示：

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

最大增量由三角形(或"flag")给出。之后是完整的线条(倒钩)。最小的增量是半线。当然，最多只有 1 条半线。如果幅度很小并且只需要一个half-line 并且没有完整的线或三角形，则half-line 会从倒钩的末端偏移，以便可以轻松地将其与具有单个完整线的倒钩区分开来。使用标准增量 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 使用 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 布尔值，默认值：假

绘制的空倒钩(圆圈)是否应该用标志颜色填充。如果它们未填充，则中心是透明的。

rounding 布尔值，默认值：真

分配倒钩分量时是否对向量幅度进行四舍五入。如果为 True，则将幅度四舍五入到最接近的 half-barb 增量的倍数。如果为 False，则幅度被简单地截断为下一个最低倍数。

barb_increments 字典，可选

一个增量字典，指定与倒钩的不同部分相关联的值。只有那些希望覆盖的值需要被包括在内。

• 'half' - 半个倒钩(默认为 5)

• 'full' - 完整的倒钩(默认为 10)

• 'flag' - 标志(默认为 50)

flip_barb bool 或类似 bool 的数组，默认值：False

线条和标志是否应指向与法线相反的方向。正常行为是倒钩和线指向右侧(来自具有这些特征的风倒钩指向北半球的低压)。

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

返回：

barbs matplotlib.quiver.Barbs

其他参数：

data 可索引对象，可选

如果给定，所有参数也接受一个字符串 s ，它被解释为 data[s] (除非这引发异常)。

**kwargs

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

属性	说明
agg_filter	一个过滤器函数，它接受一个 (m, n, 3) 浮点数组和一个 dpi 值，并返回一个 (m, n, 3) 数组和距图像左下角的两个偏移量
alpha	类似数组或标量或无
animated	bool
antialiased 或 aa 或抗锯齿	布尔或布尔列表
array	类似数组或无
capstyle	CapStyle 或 {'butt', 'projecting', 'round'}
clim	(vmin：浮点数，vmax：浮点数)
clip_box	BboxBase 或无
clip_on	bool
clip_path	补丁或(路径，变换)或无
cmap	Colormap 或 str 或 None
color	颜色或 RGBA 元组列表
edgecolor 或 ec 或 edgecolors	颜色或颜色列表或'face'
facecolor 或 facecolors 或 fc	颜色或颜色列表
figure	Figure
gid	str
matplotlib.collections.Collection.set_hatch	{'/'、'\'、'|'、'-'、'+'、'x', 'o'、'O'、'.'、'*'}
in_layout	bool
joinstyle	JoinStyle 或 {'miter', 'round', 'bevel'}
label	object
linestyle 或破折号或线条样式或 ls	str 或元组或其列表
linewidth 或线宽或 lw	浮点数或浮点数列表
mouseover	bool
norm	Normalize 或 str 或 None
offset_transform 或 transOffset	Transform
offsets	(N, 2) 或 (2,) 类似数组
path_effects	AbstractPathEffect 列表
paths	类似数组的列表
picker	None 或 bool 或 float 或可调用
pickradius	float
rasterized	bool
sizes	numpy.ndarray 或无
sketch_params	(比例：浮点数，长度：浮点数，随机性：浮点数)
snap	布尔或无
transform	Transform
url	str
urls	str 或 None 的列表
verts	类似数组的列表
verts_and_codes	unknown
visible	bool
zorder	float