matplotlib.quiver.Barbs #

matplotlib.quiver。倒钩斧头 * args pivot = 'tip'长度= 7 barbcolor = None flagcolor = None sizes = None fill_empty = False barb_increments = None rounding = True flip_barb = False ** kwargs[来源] #

基地:PolyCollection

用于倒钩的专业 PolyCollection。

唯一的 API 方法是set_UVC(),可用于更改箭头的大小、方向和颜色。set_offsets()使用收集方法更改位置。这种方法可能在动画中很有用。

有一个内部函数_find_tails()可以在给定矢量幅度的情况下准确找到应该放在倒钩上的内容。从那里_make_barbs()用于查找多边形的顶点以根据此信息表示倒钩。

构造函数接受一个必需的参数,一个 Axes 实例,后跟以下 pyplot 接口文档描述的 args 和 kwargs:

绘制一个 2D 倒钩场。

来电签名:

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

其中XY定义倒钩位置,UV定义倒钩方向,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 位置的信息,请参见枢轴。

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

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

U、V 1D 或 2D 类阵列

倒钩轴的 x 和 y 分量。

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

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

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

长度浮点数,默认值:7

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

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

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

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

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

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

返回
倒钩Barbs
其他参数
数据可索引对象,可选

DATA_PARAMETER_PLACEHOLDER

**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

漂浮

barbs_doc = '\n绘制一个2D倒钩字段。 \n\n调用签名::\n\n barbs ([X, Y], U, V, [C], **kwargs)\n\n其中*X*, *Y*定义倒钩位置,* U*、*V*定义倒钩\n方向,* C *可选择设置颜色。\n\n所有参数可以1D2D。*U*、*V*、*C*可能掩码数组,   masked\n*X*, *Y* 目前 支持 \n\n倒钩 传统 气象学中用作绘制 观测速度\n和方向一种方式技术上用于\ n绘制任何二维向量数量。箭头相反\ n矢量幅度_   箭头 倒钩 通过放置倾斜\ n线三角形提供 更多 关于矢量幅度定量信息 _ _ _ _ _ _ _ _ _ \\\n : / \\ \\ \\\n : / \\ \\ \\\n : ------------------------- -----\n\n最大增量                                                                                                                                    三角形“标志”)给出。 那些\n之后是(倒钩)。最小增量线当然最多只有1线_ 如果幅值\n很小并且需要一条线没有全线\n三角形线偏移     倒钩 ​​末端 开始, 以便\n可以容易地将它带有单条实线 倒钩区分开使用标准增量50、105,\ n上面显示倒钩\n幅值名义上65。\ n\n另请参阅https://en.wikipedia.org/wiki/Wind_barb。\n\n参数\ n---------\nX, Y : 1D2D   类数组, 可选\n    倒钩位置 x y 坐标 请参阅*pivot*了解如何\n倒钩绘制x、y位置。\n\n如果给出,它们基于* U**V*维度成为统一的整数网格.\n\n如果*X**Y*                 1D *U*、 *V* 2D, *X*、 *Y* 使用 “X, Y = np.meshgrid (X, Y)”扩展 2D\n 。    这种情况下, ``len(X)````len(Y)``\n必须匹配*U*和*V*维度\n\nU, V : 1D2D数组- like \ n倒钩xy分量         轴。\n\nC : 1D 2D 类数组, 可选\n    通过*norm**cmap*进行颜色映射定义倒钩颜色数字数据\ n \ n支持颜色。如果直接设置颜色,\n使用*barbcolor*代替。\n\nlength : float,默认值:7\n倒钩长度以磅为单位                 倒钩其他 部分\n 会按此 缩放\n\npivot : { \'tip\', \ 'middle\'}浮动,默认值:\ ' tip\'\ n箭头部分锚定* X*、*Y*网格。倒钩\n围绕旋转可以一个数字,移动\n开头                倒钩 距离网格那么 \n\nbarbcolor :颜色颜色序列\ n倒钩所有部分颜色除了标志参数\n类似于多边形的* edgecolor *参数可以使用\n代替但是参数覆盖facecolor。\n\nflagcolor               : 颜色 颜色 序列\n    倒钩任何标志 颜色 参数类似于多边形\n *facecolor *参数可以改为使用但是,\n参数覆盖facecolor。如果没有设置(并且*C*没有设置,那么* flagcolor *                 设置 匹配*barbcolor*以便\ n倒钩具有统一颜色如果设置*C* *flagcolor*无效\n\nsizes : dict,可选\n系数字典指定\ n特征倒钩长度比率只有那些希望得到\n                 需要 包括覆盖_ 这些特征包括:\n\n - \'spacing\' -特征之间的空间(标志、全/半倒钩)\n - \'height\' -标志倒钩高度顶部的距离)\ n - \'width\' -标志宽度完整倒钩宽度的两倍\n - \ ' emptybarb \ '                   - 用于低幅度半径 \n\nfill_empty : bool 默认值:False\n绘制倒钩(圆)是否应该\ n标志颜色填充如果它们没有填充,中心是透明。\n\nrounding : bool,默认:True\n向量幅度是否应该               在分配barb\n组件进行四舍五入。 如果True,则将幅度四舍五入最接近\n倒钩增量的倍数。如果为False,幅度简单地截断为\n一个最小倍数。\n\nbarb_increments : dict,可选\n指定关联增量字典\n                         倒钩不同部分 只有那些希望\n覆盖需要包含在内。\n\n - \'half\' -倒钩(默认5)\n - \'full\' -倒钩(默认10)\n - \'flag\' -标志(默认50)\n\nflip_barb : bool类似数组bool,默认:False\n是否                     线条 旗帜 指向 正常相反 \n正常行为倒钩线条指向右侧(来自\n具有这些特征倒钩指向北半球低压\ n \n\n A单个应用于所有倒钩_ 单个倒钩可以                 通过\n    传递 *U*和*V*大小相同 布尔 数组 翻转。\n\n返回\n-------\nbarbs : ` ~ matplotlib.quiver.Barbs`\n\n其他参数\n----------------\ndata :可索引对象,可选\n DATA_PARAMETER_PLACEHOLDER\n\n**kwargs\n可以使用`.PolyCollection`关键字进一步定义倒钩\ n 个参数:\n\n \n .. table::\n :class: property-table\n\n                                   ==================================================== ==================================================    _ ==================================================== ==================================================== ==================================================== =====\n       属性                                                                                            说明                                                                                                                                                   \n        ======================================== ==================================================== ===================================================    _ ==================================================== ==================================================== ================\n        :meth:`agg_filter <matplotlib.artist.Artist.set_agg_filter>`                                        一个 过滤 函数, 接受 一个 (m, n, 3) float 数组 一个 dpi 值, 返回 一个 (m, n , 3 ) 数组 图像左下角两个偏移 \ n :meth:`alpha <matplotlib.collections.Collection.set_alpha>` array- likescalarNone \n :meth:`animated <matplotlib.artist.Artist.set_animated>` bool \n :meth:`antialiased <matplotlib.collections.Collection.set_antialiased>`aa                                                                                                                                                                                                                                                                                                                                                                                                       or antialiaseds        bool or list of bools                                                                                                                                          \n        :meth:`array <matplotlib.cm.ScalarMappable.set_array>`                                               array-like or None                                                                                                                                             \n        :meth:`capstyle <matplotlib.collections.Collection.set_capstyle>`                                    `.CapStyle` {\'butt\', \'projecting\', \'round\'}                                                                                                                 \n        :meth:`clim <matplotlib.cm.ScalarMappable.set_clim>`                                                 (vmin: float, vmax: float)                                                                                                                                     \n        :meth :`clip_box <matplotlib.artist.Artist.set_clip_box>`                                             `.Bbox`                                                                                                                                                        \n        :meth:`clip_on <matplotlib.artist.Artist.set_clip_on>`                                               bool                                                                                                                                                           \n        :meth:`clip_path <matplotlib.artist.Artist.set_clip_path>`                                           Patch or (Path, Transform) or None                                                                                                                             \n        :meth:`cmap <matplotlib.cm.ScalarMappable .set_cmap>`                                                 `.Colormap` str None                                                                                                                                     \n        :meth:`color <matplotlib.collections.Collection.set_color>`                                         颜色 rgba元组列表\ n :meth:`edgecolor <matplotlib.collections.Collection.set_edgecolor >`ecedgecolors颜色                                                                                                                                                       颜色列表 \'face\' \n :meth:`facecolor < matplotlib.collections.Collection.set_facecolor>`facecolorsfc颜色颜色列表\n : meth:`figure <matplotlib.artist.Artist. set_figure>` `.Figure` \n :meth:`gid <matplotlib.artist.Artist.set_gid>` str \n :meth:`hatch <matplotlib.collections.Collection.set_hatch>` {\'/\', \ '\\\\\', \'|\', \'-\', \'+\', \'x\', \'o\',\'O\', \'.\',                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             \'*\'}                                                                                                            \n        :meth:`in_layout <matplotlib.artist.Artist.set_in_layout>`                                           bool                                                                                                                                                           \n        :meth:`joinstyle <matplotlib.collections.Collection.set_joinstyle>`                                  `.JoinStyle` {\'miter \', \'round\', \'bevel\'}                                                                                                                    \n        :meth:`label <matplotlib.artist.Artist.set_label>`                                                  对象                                                                                                                                                        \n        :meth:`linestyle <matplotlib.collections.Collection.set_linestyle>` 破折号 线条样式 ls str   或其 列表 \n :meth:`linewidth                                                                                                                                         <matplotlib.collections.Collection.set_linewidth>` or linewidths or lw              float or list of floats                                                                                                                                        \n        :meth:`mouseover <matplotlib.artist.Artist.set_mouseover>`                                           bool                                                                                                                                                           \n        :meth:`norm <matplotlib.cm.ScalarMappable .set_norm>`                                                 `.Normalize` or str or None                                                                                                                                    \n        :meth:`offset_transform <matplotlib.collections.Collection.set_offset_transform>` or transOffset     unknown                                                                                                                                                        \n        :meth:`offsets <matplotlib.collections.Collection.set_offsets>`                                      ( N, 2) (2,) 类数组                                                                                                                                     \n        :meth:`path_effects <matplotlib.artist.Artist.set_path_effects>`                                     `.AbstractPathEffect`                                                                                                                                          \n        :meth:`paths <matplotlib.collections.PolyCollection.set_verts>`                                     数组列表 \n :meth :` picker < matplotlib.artist.Artist.set_picker>` None or bool or float or callable \n :meth:`pickradius <matplotlib.collections.Collection.set_pickradius>`未知\n :meth:`rasterized <matplotlib.artist. Artist.set_rasterized>` bool \n :meth:`sizes                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              <matplotlib.collections._CollectionWithSizes.set_sizes>`                                ndarray                                                                                                                                                \n        :meth:`sketch_params <matplotlib.artist.Artist.set_sketch_params>`                                   (比例: float, 长度: float, 随机性: float)                                                                                                              \n        :meth:`snap <matplotlib.artist.Artist.set_snap>`                                                     bool None                                                                                                                                                   \n        :meth:`transform <matplotlib.artist.Artist.set_transform>`                                           `.Transform`                                                                                                                                                   \n        :meth:`url <matplotlib.artist.Artist.set_url> `                                                       str                                                                                                                                                            \n        :meth:`urls < matplotlib.collections.Collection.set_urls>`                                            str列表                                                                                                                                            \n        :meth :`verts <matplotlib.collections.PolyCollection.set_verts> `                                     类似数组的列表\ n :meth:`verts_and_codes <matplotlib.collections.PolyCollection.set_verts_and_codes>`未知\n :meth:`visible < matplotlib.artist.Artist.set_visible>` bool \n :meth:`zorder <matplotlib.artist.Artist.set_zorder>` float \n =================== ==================================================== =================================================== _ ==================================================== ==================================================== =====================================\n\n'                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     #
设置* UVC=<UNSET> agg_filter=<UNSET> alpha=<UNSET>动画=<UNSET>抗锯齿=<UNSET>数组=<UNSET> capstyle=<UNSET> clim=<UNSET > , clip_box=<UNSET> , clip_on=<UNSET> , clip_path=<UNSET> , cmap=<UNSET> , color=<UNSET> , edgecolor=<UNSET> , facecolor=<UNSET> , gid=<UNSET> ,孵化=<UNSET> , in_layout=<UNSET> , joinstyle=<UNSET>, label=<UNSET> , linestyle=<UNSET> , linewidth=<UNSET> , mouseover=<UNSET> , norm=<UNSET> , offset_transform=<UNSET> , offsets=<UNSET> , path_effects=<UNSET> ,路径=<UNSET > , picker=< UNSET> , pickradius=<UNSET> , rasterized=<UNSET> , sizes=<UNSET> , sketch_params=<UNSET> , snap=<UNSET> , transform=<UNSET> , url=< UNSET> , urls=<UNSET> ,verts=<UNSET> ,verts_and_codes=<UNSET> , visible=<UNSET> , zorder=<UNSET> ) [来源] #

一次设置多个属性。

支持的属性是

财产

描述

UVC

未知

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

浮点数对的序列

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

漂浮

set_UVC ( U , V , C = None ) [来源] #
set_offsets ( xy ) [来源] #

设置倒钩多边形的偏移量。这会保存传入的偏移量,并根据现有的 U/V 数据对它们进行屏蔽。

参数
浮点数对的xy序列