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, 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 Число единиц данных на единицу длины стрелки, например, м/с на единицу ширины графика; меньший параметр 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. 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 массив ndarray 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.pyplot.quiver

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

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

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