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, optional, 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, 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 строка str 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 строка str urls Список [str] или None visible bool zorder число float

См. также

quiverkey

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

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

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

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

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

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