matplotlib.axes.Axes.quiver

Axes.quiver(*args, data=None, **kw) [source]

Отобразить 2-мерное поле стрелок.

Вызовы:

quiver(U, V, **kw)
quiver(U, V, C, **kw)
quiver(X, Y, U, V, **kw)
quiver(X, Y, U, V, C, **kw)

U и V — данные стрелок, X и Y — задают положение стрелок, а C — цвет стрелок. Эти аргументы могут быть одномерными или двумерными массивами или последовательностями.

Если X и Y отсутствуют, они будут сгенерированы как равномерная сетка. Если U и V являются двумерными массивами, а X и Y — одномерными, и если len(X) и len(Y) соответствуют столбцам и строкам U, тогда X и Y будут расширены с помощью numpy.meshgrid().

По умолчанию длина стрелок автоматически масштабируется до разумного размера. Чтобы изменить это поведение, см. ключевые параметры scale и scale_units.

Значения по умолчанию дают стрелку с немного загнутым наконечником; чтобы сделать наконечник треугольным, установите headaxislength равным headlength. Чтобы сделать стрелку более острой, уменьшите headwidth или увеличьте headlength и headaxislength. Чтобы сделать наконечник меньше относительно ствола, уменьшите все параметры наконечника. Вероятно, лучше оставить minshaft без изменений.

linewidths и edgecolors могут быть использованы для настройки контуров стрелок.

Параметры:

X : 1D or 2D array, sequence, optional Координаты x расположения стрелок Y : 1D or 2D array, sequence, optional Координаты y расположения стрелок U : 1D or 2D array or masked array, sequence Компоненты x векторов стрелок V : 1D or 2D array or masked array, sequence Компоненты y векторов стрелок C : 1D or 2D array, sequence, optional Цвета стрелок units : [ 'width' | 'height' | 'dots' | 'inches' | 'x' | 'y' | 'xy' ] Размеры стрелок (кроме length) измеряются в кратных этому единице. 'width' или 'height': ширина или высота оси 'dots' или 'inches': пиксели или дюймы, в зависимости от dpi фигуры 'x', 'y' или 'xy': соответственно X, Y или в единицах данных Стрелки масштабируются по-разному в зависимости от единиц. Для 'x' или 'y' стрелки увеличиваются при приближении; для других единиц размер стрелки не зависит от состояния масштабирования. Для 'width' или 'height' размер стрелки увеличивается с шириной и высотой осей соответственно при изменении размера окна; для 'dots' или 'inches' изменение размера не изменяет стрелки. angles : [ 'uv' | 'xy' ], array, optional Метод определения угла стрелок. По умолчанию 'uv'. 'uv': коэффициент аспекта оси стрелки равен 1, поэтому, если U*==*V, ориентация стрелки на графике составляет 45 градусов против часовой стрелки от горизонтальной оси (положительная вправо). 'xy': стрелки направлены от (x,y) к (x+u, y+v). Используйте это, например, для построения градиентного поля. В качестве альтернативы, произвольные углы могут быть заданы как массив значений в градусах, против часовой стрелки от горизонтальной оси. Примечание: инвертирование оси данных будет соответственным образом инвертировать стрелки только с angles='xy'. scale : None, float, optional Число единиц данных на единицу длины стрелки, например, м/с на единицу ширины графика; меньший параметр масштаба делает стрелку длиннее. По умолчанию — None. Если None, используется простой алгоритм автоматического масштабирования, основанный на средней длине вектора и количестве векторов. Единица длины стрелки задаётся параметром scale_units scale_units : [ 'width' | 'height' | 'dots' | 'inches' | 'x' | 'y' | 'xy' ], None, optional Если ключевой параметр scale равен None, единица длины стрелки. По умолчанию — None. Например, scale_units — 'inches', scale — 2.0, и (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 : scalar, optional Ширина ствола стрелки в единицах стрелки; по умолчанию зависит от выбора единиц, указанных выше, и количества векторов; типичное начальное значение составляет около 0,005 от ширины графика. headwidth : scalar, optional Ширина наконечника как кратная ширине ствола, по умолчанию 3 headlength : scalar, optional Длина наконечника как кратная ширине ствола, по умолчанию 5 headaxislength : scalar, optional Длина наконечника на пересечении со стволом, по умолчанию 4.5 minshaft : scalar, optional Длина, ниже которой стрелка масштабируется, в единицах длины наконечника. Не устанавливайте это значение меньше 1, иначе маленькие стрелки будут выглядеть ужасно! По умолчанию 1 minlength : scalar, optional Минимальная длина как кратная ширине ствола; если длина стрелки меньше этого значения, вместо неё отображается точка (шестиугольник) этого диаметра. По умолчанию 1. pivot : [ 'tail' | 'mid' | 'middle' | 'tip' ], optional Часть стрелки, которая находится в точке сетки; стрелка вращается вокруг этой точки, отсюда и название pivot. color : [ color | color sequence ], optional Это синоним ключевого параметра PolyCollection facecolor. Если C задано, color не имеет эффекта.

См. также

quiverkey

Добавить ключ к диаграмме стрелок

Примечания

Дополнительные PolyCollection ключевые параметры:

Свойство	Описание
agg_filter	функция фильтра, которая принимает массив float (m, n, 3) и значение dpi, и возвращает массив (m, n, 3)
alpha	float или None
animated	bool
antialiased	bool или последовательность bool
array	массив ndarray
capstyle	{'butt', 'round', 'projecting'}
clim	последовательность из 2 чисел с плавающей точкой; может быть переопределена в методах, имеющих vmin и vmax параметры.
clip_box	Bbox
clip_on	bool
clip_path	[(Path, Transform) | Patch | None]
cmap	колорирование или зарегистрированное имя колорирования
color	matplotlib цвет или последовательность кортежей rgba
contains	вызываемый объект
edgecolor	цвет или последовательность цветов
facecolor	цвет или последовательность цветов
figure	Figure
gid	str
hatch	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
in_layout	bool
joinstyle	{'miter', 'round', 'bevel'}
label	объект
linestyle	{'-', '--', '-.', ':', '', (смещение, последовательность включений-выключений), ...}
linewidth	число с плавающей точкой или последовательность чисел с плавающей точкой
norm	Normalize
offset_position	{'screen', 'data'}
offsets	число с плавающей точкой или последовательность чисел с плавающей точкой
path_effects	AbstractPathEffect
picker	None или bool или float или вызываемый объект
pickradius	неизвестно
rasterized	bool или None
sketch_params	(масштаб: float, длина: float, случайность: float)
snap	bool или None
transform	Transform
url	строка
urls	список строк или None
visible	bool
zorder	число с плавающей точкой

Примеры использования matplotlib.axes.Axes.quiver

Демонстрация расширенных функций quiver и quiverkey

Простой пример Quiver

Демонстрация Trigradient