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, 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, 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 число с плавающей точкой или список чисел с плавающей точкой 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 число с плавающей точкой

См. также

Axes.quiverkey

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

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

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

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

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

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