matplotlib.quiver.Quiver¶

class matplotlib.quiver.Quiver(ax, *args, scale=None, headwidth=3, headlength=5, headaxislength=4.5, minshaft=1, minlength=1, units='width', scale_units=None, angles='uv', width=None, color='k', pivot='tail', **kw)[源代码]¶

基类：matplotlib.collections.PolyCollection

箭头的专用多集合。

唯一的API方法是set_vc（），它可以用来更改箭头的大小、方向和颜色；当类实例化时，它们的位置是固定的。这个方法可能在动画中有用。

这个类中的大部分工作都是在draw（）方法中完成的，这样就可以获得尽可能多的关于绘图的信息。在随后的draw（）调用中，重新计算仅限于可能已更改的内容，因此将计算放入draw（）方法中不会造成性能损失。

绘制二维箭头字段。

呼叫签名：

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或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`	浮动

参见

Axes.quiverkey: 在震动图中添加一个键。

__init__(ax, *args, scale=None, headwidth=3, headlength=5, headaxislength=4.5, minshaft=1, minlength=1, units='width', scale_units=None, angles='uv', width=None, color='k', pivot='tail', **kw)[源代码]¶

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