matplotlib.axes.Axes.quiver

Axes.quiver(self, *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, Y1D or 2D array-like, optional Координаты x и y расположения стрелок. Если не указаны, они будут сгенерированы как равномерная сетка целых чисел на основе размеров U и V. Если X и Y являются одномерными, а U, V — двумерными, X и Y расширяются до двумерных с помощью X, Y = np.meshgrid(X, Y). В этом случае len(X) и len(Y) должны соответствовать размерностям столбцов и строк U и V. U, V1D or 2D array-like Компоненты x и y направлений векторов стрелок. Они должны иметь одинаковое количество элементов, соответствующее количеству расположений стрелок. U и V могут быть замаскированы. Будут нарисованы только те расположения, которые не замаскированы в U, V и C. C1D or 2D array-like, optional Численные данные, определяющие цвета стрелок с помощью цветовой карты norm и cmap. Явное задание цветов не поддерживается. Если вы хотите задать цвета непосредственно, используйте color. Размер C должен соответствовать количеству расположений стрелок. units{'width', 'height', 'dots', 'inches', 'x', 'y' 'xy'}, default: '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'} or array-like, default: 'uv' Метод определения угла стрелок. 'uv': Соотношение сторон оси стрелки равно 1, поэтому, если U == V, ориентация стрелки на графике составляет 45 градусов против часовой стрелки от горизонтальной оси (положительное значение — вправо). Используйте это, если стрелки обозначают величину, не основанную на координатах данных X, Y. 'xy': Стрелки направлены от (x, y) к (x+u, y+v). Используйте это для построения поля градиента, например. В качестве альтернативы, произвольные углы могут быть явно заданы в виде массива значений в градусах, против часовой стрелки от горизонтальной оси. В этом случае U, V используются только для определения длины стрелок. Примечание: инвертирование оси данных будет соответствующим образом инвертировать стрелки только с angles='xy'. scalefloat, optional Количество единиц данных на единицу длины стрелки, например, м/с на единицу ширины графика; меньший параметр масштаба делает стрелку длиннее. По умолчанию — None. Если None, используется простой алгоритм автоматического масштабирования, основанный на средней длине вектора и количестве векторов. Единица длины стрелки задаётся параметром scale_units. scale_units{'width', 'height', 'dots', 'inches', 'x', 'y', 'xy'}, 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. widthfloat, optional Ширина ствола стрелки в единицах стрелки; значение по умолчанию зависит от выбора единиц, указанных выше, и количества векторов; типичное начальное значение составляет примерно 0,005 от ширины графика. headwidthfloat, default: 3 Ширина наконечника как кратная ширине ствола. headlengthfloat, default: 5 Длина наконечника как кратная ширине ствола. headaxislengthfloat, default: 4.5 Длина наконечника на пересечении со стволом. minshaftfloat, default: 1 Длина, ниже которой стрелка масштабируется в единицах длины наконечника. Не устанавливайте это значение меньше 1, иначе маленькие стрелки будут выглядеть ужасно! minlengthfloat, default: 1 Минимальная длина как кратная ширине ствола; если длина стрелки меньше этого значения, вместо неё рисуется точка (шестиугольник) такого диаметра. pivot{'tail', 'mid', 'middle', 'tip'}, default: 'tail' Часть стрелки, которая закреплена на сетке X, Y. Стрелка вращается вокруг этой точки. 'mid' — синоним 'middle'. colorcolor or color sequence, optional Явный(ые) цвет(ы) для стрелок. Если C задан, color не оказывает влияния. Это синоним параметра PolyCollection facecolor.

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

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

См. также

Axes.quiverkey

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

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

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

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

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

3D график стрелок