当前位置: 首页>>代码示例 >>用法及示例精选 >>正文


Python matplotlib.axes.Axes.barbs用法及代码示例


用法

Axes.barbs(*args, data=None, **kwargs)

绘制一个 2D 倒钩场。

调用签名:

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

其中 XY 定义倒钩位置, UV 定义倒钩方向, 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 一维或二维array-like,可选

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

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

如果 XY 是一维的,但 UV 是二维的,则 XY 使用 X, Y = np.meshgrid(X, Y) 扩展为二维。在这种情况下,len(X)len(Y) 必须与 UV 的列和行维度匹配。

U, V 一维或二维array-like

倒钩轴的 x 和 y 分量。

C 一维或二维array-like,可选

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

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

length 浮点数,默认值:7

倒钩的长度(以点为单位);倒钩的其他部分与此相对。

pivot {'tip', 'middle'} 或浮点数,默认:'tip'

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

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 或 array-like of bool,默认值:False

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

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

返回

barbs matplotlib.quiver.Barbs

其他参数

data 可索引对象,可选

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

**kwargs

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

属性

说明

agg_filter

一个过滤函数,它接受一个 (m, n, 3) 浮点数组和一个 dpi 值,并返回一个 (m, n, 3) 数组

alpha

array-like 或标量或无

animated

bool

antialiased 或 aa 或抗锯齿

布尔或布尔列表

array

array-like 或无

capstyle

CapStyle 或 {'butt', 'projecting', 'round'}

clim

(vmin:浮点数,vmax:浮点数)

clip_box

matplotlib.transforms.Bbox

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

浮点数或浮点数列表

norm

Normalize 或无

offset_transform

Transform

offsets

(N, 2) 或 (2,) array-like

path_effects

AbstractPathEffect

paths

array-like列表

picker

None 或 bool 或 float 或可调用

pickradius

float

rasterized

bool

sizes

ndarray 或无

sketch_params

(比例:浮点数,长度:浮点数,随机性:浮点数)

snap

布尔或无

transform

Transform

url

str

urls

str 或 None 的列表

verts

array-like列表

verts_and_codes

unknown

visible

bool

zorder

float

相关用法


注:本文由纯净天空筛选整理自matplotlib.org大神的英文原创作品 matplotlib.axes.Axes.barbs。非经特殊声明,原始代码版权归原作者所有,本译文未经允许或授权,请勿转载或复制。