matplotlib.pyplot.quiver

matplotlib.pyplot.quiver(*args, **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 или antialiaseds	Булево значение или последовательность булевых значений
array	массив ndarray
capstyle	неизвестно
clim	последовательность из 2 чисел с плавающей точкой; может быть переопределён в методах, имеющих vmin и vmax параметры.
clip_box	экземпляр Bbox
clip_on	bool
clip_path	[(Path, Transform) | Patch | None]
cmap	колормэп или зарегистрированное имя колормэпа
color	matplotlib цвет или последовательность rgba кортежей
contains	вызываемая функция
edgecolor или edgecolors	matplotlib цветовое значение или последовательность значений
facecolor или facecolors	matplotlib цветовое значение или последовательность значений
figure	экземпляр Figure
gid	строковое идентификатор
hatch	['/' | '\' | '|' | '-' | '+' | 'x' | 'o' | 'O' | '.' | '*']
joinstyle	неизвестно
label	объект
linestyle или штрихи или стили линии	['сплошная' | 'штриховая', 'штрихпунктирная', 'пунктирная' | (смещение, последовательность чередования) | '-' | '--' | '-.' | ':' | 'None' | ' ' | '']
linewidth или linewidths или lw	число с плавающей точкой или последовательность чисел с плавающей точкой
norm	Normalize
offset_position	[ 'экран' | 'данные' ]
offsets	число с плавающей точкой или последовательность чисел с плавающей точкой
path_effects	AbstractPathEffect
picker	[None | bool | float | вызываемая функция]
pickradius	расстояние в точках
rasterized	bool или None
sketch_params	(масштаб: float, длина: float, случайность: float)
snap	bool или None
transform	Transform
url	строка url
urls	Список[строка] или None
visible	bool
zorder	float

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

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

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

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