matplotlib.axes.Axes.quiver

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

Построение 2D поля стрелок.

Вызов:

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

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

Размер стрелок

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

Форма стрелок

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

Контур стрелки

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

Параметры:

Параметры:	X, YОдномерный или двумерный массив-подобный объект, необязательно Координаты x и y расположения стрелок. Если не указаны, они будут сгенерированы как равномерная сетка целых чисел на основе размеров U и V. Если X и Y одномерные, а 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Одномерный или двумерный массив-подобный объект, необязательно Числовые данные, определяющие цвета стрелок с помощью цветовой карты norm и cmap. Это не поддерживает явные цвета. Если нужно установить цвета напрямую, используйте color. Размер C должен соответствовать количеству расположений стрелок. units{'width', 'height', 'dots', 'inches', 'x', 'y', 'xy'}, по умолчанию: 'width' Размеры стрелок (кроме length) измеряются в единицах этого параметра. Поддерживаются следующие значения: 'width', 'height': Ширина или высота оси. 'dots', 'inches': Пиксели или дюймы, основанные на dpi фигуры. 'x', 'y', 'xy': X, Y или \(\sqrt{X^2 + Y^2}\) в единицах данных. Стрелки масштабируются по-разному в зависимости от единиц. Для 'x' или 'y' стрелки увеличиваются при приближении; для других единиц размер стрелок не зависит от состояния масштабирования. Для 'width' или 'height' размер стрелки увеличивается вместе с шириной и высотой осей соответственно при изменении размера окна; для 'dots' или 'inches' изменение размера не влияет на стрелки. angles{'uv', 'xy'} или массив-подобный объект, по умолчанию: 'uv' Метод определения угла стрелок. 'uv': Соотношение сторон оси стрелки равно 1, так что если U == V, ориентация стрелки на графике составляет 45 градусов против часовой стрелки от горизонтальной оси (положительное направление вправо). Используйте этот параметр, если стрелки обозначают величину, которая не основана на координатах данных X, Y. 'xy': Стрелки направлены от (x, y) к (x+u, y+v). Используйте этот параметр для построения поля градиента, например. В качестве альтернативы, произвольные углы могут быть заданы явно в виде массива значений в градусах, против часовой стрелки от горизонтальной оси. В этом случае U, V используется только для определения длины стрелок. Примечание: инвертирование оси данных будет соответствующим образом инвертировать стрелки только с `angles='xy'`. scaleчисло, необязательно Количество единиц данных на единицу длины стрелки, например, м/с на единицу ширины графика; меньший параметр scale делает стрелку длиннее. Значение по умолчанию — None. Если None, используется простой алгоритм автоматического масштабирования, основанный на средней длине вектора и количестве векторов. Единица длины стрелки задается параметром scale_units. scale_units{'width', 'height', 'dots', 'inches', 'x', 'y', 'xy'}, необязательно Если параметр 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число, необязательно Ширина хвостовика стрелки в единицах стрелок; значение по умолчанию зависит от выбранных единиц, указанных выше, и количества векторов; типичное начальное значение составляет около 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 задано, color не имеет эффекта. Это синоним параметра `PolyCollection` facecolor.

X, YОдномерный или двумерный массив-подобный объект, необязательно

Координаты x и y расположения стрелок.

Если не указаны, они будут сгенерированы как равномерная сетка целых чисел на основе размеров U и V.

Если X и Y одномерные, а 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Одномерный или двумерный массив-подобный объект, необязательно

Числовые данные, определяющие цвета стрелок с помощью цветовой карты norm и cmap.

Это не поддерживает явные цвета. Если нужно установить цвета напрямую, используйте color. Размер C должен соответствовать количеству расположений стрелок.

units{'width', 'height', 'dots', 'inches', 'x', 'y', 'xy'}, по умолчанию: 'width'

Размеры стрелок (кроме length) измеряются в единицах этого параметра.

Поддерживаются следующие значения:

'width', 'height': Ширина или высота оси.
'dots', 'inches': Пиксели или дюймы, основанные на dpi фигуры.
'x', 'y', 'xy': X, Y или \(\sqrt{X^2 + Y^2}\) в единицах данных.

Стрелки масштабируются по-разному в зависимости от единиц. Для 'x' или 'y' стрелки увеличиваются при приближении; для других единиц размер стрелок не зависит от состояния масштабирования. Для 'width' или 'height' размер стрелки увеличивается вместе с шириной и высотой осей соответственно при изменении размера окна; для 'dots' или 'inches' изменение размера не влияет на стрелки.

angles{'uv', 'xy'} или массив-подобный объект, по умолчанию: 'uv'

Метод определения угла стрелок.

'uv': Соотношение сторон оси стрелки равно 1, так что если U == V, ориентация стрелки на графике составляет 45 градусов против часовой стрелки от горизонтальной оси (положительное направление вправо).

Используйте этот параметр, если стрелки обозначают величину, которая не основана на координатах данных X, Y.
'xy': Стрелки направлены от (x, y) к (x+u, y+v). Используйте этот параметр для построения поля градиента, например.
В качестве альтернативы, произвольные углы могут быть заданы явно в виде массива значений в градусах, против часовой стрелки от горизонтальной оси.

В этом случае U, V используется только для определения длины стрелок.

Примечание: инвертирование оси данных будет соответствующим образом инвертировать стрелки только с angles='xy'.

scaleчисло, необязательно

Количество единиц данных на единицу длины стрелки, например, м/с на единицу ширины графика; меньший параметр scale делает стрелку длиннее. Значение по умолчанию — None.

Если None, используется простой алгоритм автоматического масштабирования, основанный на средней длине вектора и количестве векторов. Единица длины стрелки задается параметром scale_units.

scale_units{'width', 'height', 'dots', 'inches', 'x', 'y', 'xy'}, необязательно

Если параметр 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число, необязательно

Ширина хвостовика стрелки в единицах стрелок; значение по умолчанию зависит от выбранных единиц, указанных выше, и количества векторов; типичное начальное значение составляет около 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 задано, color не имеет эффекта.

Это синоним параметра PolyCollection facecolor.

Другие параметры:

**kwargsPolyCollection свойства, необязательно

Все остальные ключевые аргументы передаются в PolyCollection:

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

См. также

Axes.quiverkey: Добавить ключ к графику векторов.

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

Расширенные функции quiver и quiverkey

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

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

График quiver в 3D

matplotlib.axes.Axes.quiver

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

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