matplotlib.axes.Axes.quiver¶
-
Axes.
quiver
(*args, data=None, **kw)[源代码]¶ 绘制二维箭头字段。
呼叫签名:
quiver([X, Y], U, V, [C], **kw)
X , Y 定义箭头位置, U , V 定义箭头方向,以及 C 可以选择设置颜色。
箭头的大小
默认设置会自动将箭头的长度调整为合理的大小。要更改此行为,请参见 规模 和 scale_units 参数。
箭头形状
默认值给出一个稍微向后扫掠的箭头;要使头部成为三角形,请使 头轴长度 一样 头长 . 要使箭头更尖,请减少 头宽 或增加 头长 和 头轴长度 . 要使头部相对于轴更小,请缩小所有头部参数。你最好别管明沙夫了。
箭头轮廓
线宽度 和 绿色染料 可用于自定义箭头轮廓。
参数: - X, Y一维或二维阵列,可选
箭头位置的x和y坐标。
如果没有给出,它们将根据 U 和 V .
如果 X 和 Y 是1D但是 U , V 是二维的, X , Y 使用
X, Y = np.meshgrid(X, Y)
. 在这种情况下len(X)
和len(Y)
必须匹配的列和行维度 U 和 V .- U, V一维或二维阵列
箭头向量的x和y方向分量。
它们必须具有相同数量的元素,与箭头位置的数量相匹配。 U 和 V 可能是蒙面的。仅在未遮罩的位置 U , V 和 C 将被抽取。
- C一维或二维阵列,可选
通过colormapping定义箭头颜色的数值数据 norm 和 cmap .
这不支持显式颜色。如果要直接设置颜色,请使用 颜色 相反。大小 C 必须匹配箭头位置的数量。
- units{'width'、'height'、'dots'、'inches'、'x'、'y''xy'},默认值:'width'
箭头尺寸(除了 长度 )以该单位的倍数计量。
支持以下值:
- “宽度”、“高度”:轴的宽度或高度。
- “点”、“英寸”:基于图形dpi的像素或英寸。
- “x”、“y”、“xy”: X , Y 或 \(\sqrt{{X^2 + Y^2}}\) 以数据单位表示。
箭头的比例因单位而异。对于“x”或“y”,箭头随着一个放大而变大;对于其他单位,箭头大小与缩放状态无关。对于“宽度”或“高度”,调整窗口大小时,箭头大小分别随轴的宽度和高度增加;对于“点”或“英寸”,调整大小不会更改箭头。
- angles{uv',xy}或类似数组的,默认值:“uv”
确定箭头角度的方法。
“uv”:箭头轴纵横比为1,因此如果 U = V 绘图上箭头的方向与水平轴(从正到右)逆时针45度。
如果箭头表示不基于的数量,请使用此选项 X , Y 数据坐标。
“xy”:箭头从(x,y)指向(x+u,y+v)。例如,在绘制渐变场时使用此选项。
或者,可以将任意角度明确指定为从水平轴逆时针方向以度数为单位的数组。
In this case U, V is only used to determine the length of the arrows.
注意:反转数据轴将相应地反转箭头,只使用
angles='xy'
.- scale可选浮动
每个箭头长度单位的数据单位数,例如每个绘图宽度的m/s;较小的比例参数使箭头更长。默认是 None .
如果 None 根据平均向量长度和向量数目,采用了一种简单的自动缩放算法。箭头长度单位由 scale_units 参数。
- scale_units{'width'、'height'、'dots'、'inches'、'x'、'y'、'xy'},可选
如果 规模 克瓦格群岛 None ,箭头长度单位。默认是 None .
例如 scale_units 是英寸, 规模 是2,
(u, v) = (1, 0)
,那么向量将是0.5英寸长。如果 scale_units 是'width'或'height',则矢量为轴宽/高的一半。
如果 scale_units 为“x”,则矢量为0.5 x轴单位。若要在x-y平面中绘制向量,且u和v的单位与x和y相同,请使用
angles='xy', scale_units='xy', scale=1
.- width可选浮动
以箭头单位表示的轴宽度;默认值取决于单位、上方和向量数目的选择;典型的起始值约为绘图宽度的0.005倍。
- headwidth浮动,默认值:3
头部宽度为轴宽度的倍数。
- headlength浮动,默认值:5
头部长度为轴宽度的倍数。
- headaxislength浮动,默认值:4.5
竖井交叉处的头部长度。
- minshaft浮点,默认值:1
箭头刻度以下的长度,以头部长度为单位。不要将此设置为小于1,否则小箭头将看起来很糟糕!
- minlength浮点,默认值:1
最小长度是轴宽度的倍数;如果箭头长度小于此值,则绘制此直径的点(六边形)。
- pivot{'tail','mid','middle','tip'},默认值:'tail'
锚定到的箭头部分 X , Y 网格。箭头围绕该点旋转。
“mid”是“middle”的同义词。
- color颜色或颜色顺序,可选
箭头的显式颜色。如果 C 已经被设定, 颜色 没有效果。
This is a synonym for the
PolyCollection
facecolor parameter.
其他参数: - **kwargs :
PolyCollection
属性,可选多集合属性,可选 所有其他关键字参数都传递给
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或Nonecolor
rgba元组的颜色或列表 contains
未知的 edgecolor
或ec或edgecolors颜色或颜色列表或“面” facecolor
或者facecolors或者fc颜色或颜色列表 figure
Figure
gid
STR hatch
'/'、''、''、'-'、'+'、'X'、'O'、'O'、'、'、'*' in_layout
布尔 joinstyle
'miter'、'round'、'bevel' label
对象 linestyle
或虚线或线型或lsstr或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
浮动
参见
Axes.quiverkey
- 在震动图中添加一个键。