matplotlib.pyplot.quiver

matplotlib.pyplot.quiver(*args, data=None, **kwargs)[source]

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

Вызов функции:

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

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

Каждая стрелка внутренне представлена заполненным полигоном с шириной линии края по умолчанию 0. В результате стрелка представляет собой скорее заполненную область, а не линию со стрелкой, и свойства PolyCollection , такие как linewidth, linestyle, facecolor и т. д., действуют соответственно.

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

По умолчанию длина стрелок автоматически масштабируется до разумного размера. Чтобы изменить это поведение, см. параметры 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число, необязательно

Количество единиц данных на единицу длины стрелки, например, м/с на ширину графика; меньший параметр масштаба делает стрелку длиннее. Значение по умолчанию — 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.

Возвращает

Quiver

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

dataиндексируемый объект, необязательно

Если задано, все параметры также принимают строку s, которая интерпретируется как data[s] (если это не вызывает исключение).

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

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

Свойство	Описание
agg_filter	функция фильтра, которая принимает массив с плавающей точкой (m, n, 3) и значение dpi, и возвращает массив (m, n, 3)
alpha	массивоподобный объект, скаляр или None
animated	bool
antialiased или aa или antialiaseds	bool или список bool
array	массивоподобный объект или 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 или строка или None
color	цвет или список кортежей rgba
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_transform	Transform
offsets	массивоподобный объект (N, 2) или (2,)
path_effects	AbstractPathEffect
paths	список массивоподобных объектов
picker	None или bool или число с плавающей точкой или вызываемый объект
pickradius	число с плавающей точкой
rasterized	bool
sizes	массив NumPy или None
sketch_params	(scale: число с плавающей точкой, length: число с плавающей точкой, randomness: число с плавающей точкой)
snap	bool или None
transform	Transform
url	строка
urls	список строк или None
verts	список массивоподобных объектов
verts_and_codes	неизвестно
visible	bool
zorder	число с плавающей точкой

См. также

Axes.quiverkey

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