matplotlib.pyplot.quiver

matplotlib.pyplot.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

Добавление ключа к графику quiver

Примечания

Дополнительные параметры 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 или число с плавающей точкой или вызываемая функция
pickradius	неизвестно
rasterized	bool или None
sketch_params	(масштаб: число с плавающей точкой, длина: число с плавающей точкой, случайность: число с плавающей точкой)
snap	bool или None
transform	Transform
url	строка str
urls	список строк List[str] или None
visible	bool
zorder	число с плавающей точкой

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

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

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

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