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, Y : 1D 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, V : 1D or 2D array-like Компоненты x и y направлений векторов стрелок. C : 1D or 2D array-like, optional Числовые данные, которые определяют цвета стрелок с помощью цветовой карты посредством norm и cmap. Это не поддерживает явные цвета. Если вы хотите установить цвета напрямую, используйте color вместо этого. 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'. scale : float, 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. width : float, optional Ширина вала в единицах стрелки; по умолчанию зависит от выбора единиц, указанных выше, и количества векторов; типичное начальное значение составляет примерно 0,005 от ширины графика. headwidth : float, optional, default: 3 Ширина головки как кратное ширине вала. headlength : float, optional, default: 5 Длина головки как кратное ширине вала. headaxislength : float, optional, default: 4.5 Длина головки в точке пересечения с валом. minshaft : float, optional, default: 1 Длина, ниже которой стрелка масштабируется, в единицах длины головки. Не устанавливайте это значение меньше 1, иначе маленькие стрелки будут выглядеть ужасно! minlength : float, optional, default: 1 Минимальная длина как кратное ширины вала; если длина стрелки меньше этого значения, рисуется точка (шестиугольник) этого диаметра. pivot : {'tail', 'mid', 'middle', 'tip'}, optional, default: 'tail' Часть стрелки, прикрепленная к сетке X, Y. Стрелка вращается вокруг этой точки. 'mid' — синоним для 'middle'. color : color or color sequence, optional Явный(ые) цвет(а) для стрелок. Если C задан, color не имеет эффекта. Это синоним параметра PolyCollection facecolor.

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

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

См. также

quiverkey

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

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

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

Простой пример отображения векторов

Демонстрация вычисления градиента