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)

其中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
其他参数:
数据可索引对象,可选

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所有参数都可以是1D或2D。*U*、*V*、*C*可能是掩码数组,但   masked\n*X*, *Y* 目前 不 支持 。 \n\n倒钩 传统 上 在气象学中用作绘制 风观测速度\n和方向的一种方式,但在技术上可用于\ n绘制任何二维向量数量。与箭头相反,它\ n将矢量幅度由_   箭头 , 倒钩 通过放置倾斜的\ n线或三角形来提供 更多 关于矢量幅度的定量信息 _ _ _ _ _ _ _ _ _ \\\n : / \\ \\ \\\n : / \\ \\ \\\n : ------------------------- -----\n\n最大增量为                                                                                                                                    由 三角形(或“标志”)给出。 在那些\n之后是整行(倒钩)。最小的增量是半线。当然,最多只有1条半线。_ 如果幅值\n很小并且只需要一条半线而没有全线或\n三角形,则半线偏移     从 倒钩的 ​​末端 开始, 以便\n可以很容易地将它与带有单条实线的 倒钩区分开来。使用标准增量50、10和5,\ n上面显示的倒钩的\n幅值名义上为65。\ n\n另请参阅https://en.wikipedia.org/wiki/Wind_barb。\n\n参数\ n---------\nX, Y : 1D或2D   类数组, 可选\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 : 1D或2D数组- like \ n倒钩的x和y分量         轴。\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- like或scalar或None \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 >`或ec或edgecolors颜色                                                                                                                                                       或 颜色列表 或 \'face\' \n :meth:`facecolor < matplotlib.collections.Collection.set_facecolor>`或facecolors或fc颜色或颜色列表\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序列