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 。

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

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

最大增量由三角形（或“标志”）给出。之后是完整的线条（倒钩）。最小的增量是半线。当然，最多只有 1 条半线。如果幅值很小，只需要一条半线而没有实线或三角形，则将半线从倒钩的末端偏移，以便与单条实线的倒钩区分开来。使用标准增量 50、10 和 5，上述倒钩的大小名义上为 65。

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

参数：

X、Y 1D 或 2D 类数组，可选

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

如果没有给出，它们将根据U和V的尺寸生成为统一的整数网格网格。

如果X和Y是 1D 但U，V是 2D，X，Y使用 扩展为 2D 。在这种情况下，并且必须匹配U和V 的列和行尺寸。X, Y = np.meshgrid(X, Y)len(X)len(Y)

U、V 1D 或 2D 类阵列

倒钩轴的 x 和 y 分量。

C 1D 或 2D 类数组，可选

通过norm和 cmap进行颜色映射定义倒钩颜色的数值数据。

这不支持显式颜色。如果要直接设置颜色，请改用barbcolor。

长度浮点数，默认值：7

倒钩的长度（以点为单位）；倒钩的其他部分与此相对。

枢轴{'tip', 'middle'} 或浮动，默认值：'tip'

锚定到X、Y网格的箭头部分。倒钩围绕这一点旋转。这也可以是一个数字，它将倒钩的起点从网格点移开很多点。

barbcolor颜色或颜色序列

除旗帜外，倒钩所有部分的颜色。这个参数类似于多边形的edgecolor参数，可以用它来代替。但是，此参数将覆盖 facecolor。

flagcolor颜色或颜色序列

倒钩上任何标志的颜色。这个参数类似于多边形的 facecolor参数，可以用它来代替。但是，此参数将覆盖 facecolor。如果未设置（C也未设置），则flagcolor将设置为匹配barbcolor，以便 barb 具有统一的颜色。如果已设置C ，则 flagcolor无效。

大小字典，可选

系数字典，指定给定特征与倒钩长度的比率。只有那些希望覆盖的值需要被包括在内。这些功能包括：

• 'spacing' - 特征之间的空间（标志，全/半倒钩）

• 'height' - 旗帜或倒钩的高度（从轴到顶部的距离）

• 'width' - 标志的宽度，是完整倒钩宽度的两倍

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

fill_empty布尔值，默认值：False

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

舍入布尔值，默认值：True

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

barb_increments字典，可选

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

• 'half' - 半个倒钩（默认为 5）

• 'full' - 完整的倒钩（默认为 10）

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

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

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

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

返回：

倒钩Barbs

其他参数：

数据可索引对象，可选

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

**kwargs

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

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