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': пиксели или дюймы, в зависимости от разрешения figure '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	функция фильтра, которая принимает массив чисел с плавающей точкой (m, n, 3) и значение dpi, и возвращает массив чисел с плавающей точкой (m, n, 3)
alpha	число с плавающей точкой или None
animated	логическое значение
antialiased или antialiaseds	Булево значение или последовательность булевых значений
array	массив ndarray
capstyle	неизвестно
clim	последовательность из 2 чисел с плавающей точкой; может быть переопределено в методах, имеющих параметры vmin и vmax
clip_box	экземпляр класса Bbox
clip_on	логическое значение
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 или штрихи или linestyles	['сплошная' | 'пунктирная', 'штрихпунктирная', 'точечная' | (смещение, последовательность включений-выключений) | '-' | '--' | '-.' | ':' | 'None' | ' ' | '']
linewidth или linewidths или lw	число с плавающей точкой или последовательность чисел с плавающей точкой
norm	Normalize
offset_position	[ 'экран' | 'данные' ]
offsets	число с плавающей точкой или последовательность чисел с плавающей точкой
path_effects	AbstractPathEffect
picker	[None | логическое значение | число с плавающей точкой | вызываемая функция]
pickradius	расстояние в точках
rasterized	логическое значение или None
sketch_params	(масштаб: число с плавающей точкой, длина: число с плавающей точкой, случайность: число с плавающей точкой)
snap	логическое значение или None
transform	Transform
url	строка url
urls	Список строк или None
visible	логическое значение
zorder	число с плавающей точкой

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

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

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

Демонстрация триангулярного градиента