matplotlib.axes.Axes.barbs

Axes.barbs(*args, data=None, **kw)[源代码]

绘制一个二维倒钩区域。

呼叫签名:

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

哪里 XY 确定倒钩位置, UV 定义倒钩方向,以及 C 可以选择设置颜色。

所有参数可以是1D或2D。 UVC 可以是蒙面数组,但可以是蒙面数组 XY 目前不支持。

在气象学中,通常使用倒钩来绘制风观测的速度和方向,但在技术上可以用来绘制任何二维矢量量。与按箭头长度给出矢量大小的箭头不同,倒钩通过放置斜线或三角形以各种大小增量提供关于矢量大小的更多定量信息,如下图所示:

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

最大增量由三角形(或“标志”)给出。之后是完整的线条(倒钩)。最小的增量是半行。当然,最多只有1条半线。如果大小很小,只需要一条半直线,而不需要整条直线或三角形,则半直线将从倒钩末端偏移,这样就可以很容易地将其与具有一条整条直线的倒钩区分开来。上面显示的倒钩的大小名义上是65,使用50、10和5的标准增量。

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

参数:
X, Y一维或二维阵列,可选

倒钩位置的x和y坐标。看到了吗 枢轴 倒钩是怎么被拉到x,y位置的。

如果没有给出,它们将根据 UV .

如果 XY 是1D但是 UV 是二维的, XY 使用 X, Y = np.meshgrid(X, Y) . 在这种情况下 len(X)len(Y) 必须匹配的列和行维度 UV .

U, V一维或二维阵列

倒钩轴的x和y组件。

C一维或二维阵列,可选

通过colormapping定义倒钩颜色的数值数据 normcmap .

这不支持显式颜色。如果要直接设置颜色,请使用 芭比色 相反。

length浮点,默认值:7

倒钩的长度(以点为单位);倒钩的其他部分按比例缩放。

pivot{'tip'、'middle'}或float,默认值为:“tip”

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

barbcolor颜色或颜色顺序

除旗帜外,倒钩所有部分的颜色。此参数类似于 变色染料 多边形的参数,可以使用。但是,此参数将覆盖facecolor。

flagcolor颜色或颜色顺序

倒钩上任何旗帜的颜色。此参数类似于 脸色 参数,可以改为使用。但是,此参数将覆盖facecolor。如果未设置(和 C 也没有)那么 旗舰色彩 将设置为匹配 芭比色 使倒钩具有均匀的颜色。如果 C 已经被设定, 旗舰色彩 没有效果。

sizes可选的

一种系数词典,规定给定特征与倒钩长度之比。只需要包括希望覆盖的那些值。这些功能包括:

  • “间距”-功能之间的间距(标志、全倒钩/半倒钩)
  • “高度”-旗或全倒钩的高度(从轴到顶部的距离)
  • “宽度”-标志的宽度,是完整倒钩宽度的两倍
  • “EmptyBarb”-用于低震级的圆半径
fill_emptybool,默认值:False

所画的空倒钩(圆)是否应填充国旗颜色。如果没有填充,则中心是透明的。

roundingbool,默认值:True

在分配倒钩分量时是否应舍入矢量幅值。如果为真,则将幅值舍入为半倒钩增量的最接近倍数。如果为False,则幅值将被截断为下一个最低的倍数。

barb_increments可选的

指定与倒钩的不同部分关联的值的增量字典。只需要包括希望覆盖的那些值。

  • “半”-半倒钩(默认为5)
  • “完全”-完全倒钩(默认为10)
  • “标志”-标志(默认为50)
flip_barbbool或类似于bool的数组,默认值:False

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

单个值应用于所有倒钩。通过传递一个与 UV .

返回:
倒钩Barbs倒钩
其他参数:
**kwargs

倒钩可以进一步定制使用 PolyCollection 关键字参数:

财产 描述
agg_filter 一种过滤函数,它接受一个(m,n,3)浮点数组和一个dpi值,并返回一个(m,n,3)数组。
alpha 浮动或无
animated 布尔
antialiased 或者aa或者抗锯齿药 布尔或布尔列表
array 恩达雷
capstyle “对接”、“圆形”、“突出”
clim (V最小:浮动,V最大:浮动)
clip_box Bbox
clip_on 布尔
clip_path 面片或(路径、变换)或无
cmap Colormap 或str或None
color rgba元组的颜色或列表
contains 未知的
edgecolor 或ec或edgecolors 颜色或颜色列表或“面”
facecolor 或者facecolors或者fc 颜色或颜色列表
figure Figure
gid STR
hatch '/'、''、''、'-'、'+'、'X'、'O'、'O'、'、'、'*'
in_layout 布尔
joinstyle 'miter'、'round'、'bevel'
label 对象
linestyle 或虚线或线型或ls str或tuple或其列表
linewidth 或线宽或lw 浮动或浮动列表
norm Normalize 或无
offset_position 未知的
offsets 类似于(N,2)或(2,)
path_effects AbstractPathEffect
picker 无、布尔或可呼叫
pickradius 未知的
rasterized 布尔或无
sketch_params (比例:浮动,长度:浮动,随机性:浮动)
snap 布尔或无
transform Transform
url STR
urls str或None列表
visible 布尔
zorder 浮动

笔记

注解

除了上述参数外,此函数还可以 data 关键字参数。如果这样的话 data 参数,其他每个参数也可以是字符串 s ,解释为 data[s] (除非引起例外)。

作为传递的对象 data 必须支持项目访问 (data[s] )和会员资格测试 (s in data

使用实例 matplotlib.axes.Axes.barbs