matplotlib.pyplot.quiver

matplotlib.pyplot.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': Пиксели или дюймы, основанные на разрешении фигуры. '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': Пиксели или дюймы, основанные на разрешении фигуры.
'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`	функция фильтра, которая принимает массив (m, n, 3) float и значение 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` или dashes или 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: Добавление ключа к графику quiver.

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

Примеры графиков в Matplotlib

matplotlib.pyplot.quiver

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

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