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': Пиксели или дюймы, основанные на dpi фигуры. 'x', 'y', 'xy': X, Y или \(\sqrt{X^2 + Y^2}\) в единицах данных. Стрелки масштабируются по-разному в зависимости от единиц. Для 'x' или 'y' стрелки увеличиваются при приближении; для других единиц размер стрелок не зависит от масштаба. Для 'width' или 'height' размер стрелок увеличивается с шириной и высотой осей соответственно при изменении размера окна; для 'dots' или 'inches' изменение размера окна не влияет на размер стрелок. angles{'uv', 'xy'} or array-like, optional, default: 'uv' Метод определения угла стрелок. 'uv': Соотношение сторон оси стрелки равно 1, поэтому если U == V, ориентация стрелки на графике составляет 45 градусов против часовой стрелки от горизонтальной оси (положительное направление — вправо). Используйте этот параметр, если стрелки обозначают величину, не основанную на координатах данных X, Y. 'xy': Стрелки направлены от (x, y) к (x+u, y+v). Используйте этот параметр для построения поля градиента, например. В качестве альтернативы, произвольные углы могут быть явно заданы в виде массива значений в градусах, отсчитываемых против часовой стрелки от горизонтальной оси. В этом случае U, V используются только для определения длины стрелок. Примечание: инвертирование оси данных будет соответственно инвертировать стрелки только при angles='xy'. scalefloat, optional Количество единиц данных на единицу длины стрелки, например, м/с на ширину графика; меньшее значение параметра scale делает стрелку длиннее. Значение по умолчанию — 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, optional, default: 3 Ширина наконечника как кратное ширины хвостовой части. headlengthfloat, optional, default: 5 Длина наконечника как кратное ширины хвостовой части. headaxislengthfloat, optional, default: 4.5 Длина наконечника на пересечении с хвостовой частью. minshaftfloat, optional, default: 1 Длина, ниже которой стрелка масштабируется, в единицах длины наконечника. Не устанавливайте это значение меньше 1, иначе маленькие стрелки будут выглядеть ужасно! minlengthfloat, optional, default: 1 Минимальная длина как кратное ширины хвостовой части; если длина стрелки меньше этого значения, нарисуйте точку (шестиугольник) такого диаметра вместо неё. pivot{'tail', 'mid', 'middle', 'tip'}, optional, 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 цветовая карта или зарегистрированное имя цветовой карты 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 или последовательность float norm Normalize offset_position {'screen', 'data'} offsets массив (N, 2) или (2,) path_effects AbstractPathEffect picker None или bool или float или вызываемый объект pickradius неизвестно rasterized bool или None sketch_params (scale: float, length: float, randomness: float) snap bool или None transform Transform url строка urls Список[строка] или None visible bool zorder float

См. также

quiverkey

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

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

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

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

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

График 3D векторов