matplotlib.axes.Axes.quiver

Axes.quiver(*args, data=None, **kw)

Построение 2-мерного поля стрелок.

Возможные подписи:

quiver(U, V, **kw)
quiver(U, V, C, **kw)
quiver(X, Y, U, V, **kw)
quiver(X, Y, U, V, C, **kw)

U и V — данные стрелок, X и Y задают положение стрелок, а C — цвет стрелок. Эти аргументы могут быть одномерными или двумерными массивами или последовательностями.

Если X и Y отсутствуют, они будут сгенерированы как равномерная сетка. Если U и V — двумерные массивы, а X и Y — одномерные, и если len(X) и len(Y) соответствуют столбцам и строкам размерности U, то X и Y будут расширены с помощью numpy.meshgrid().

По умолчанию длина стрелок автоматически масштабируется до разумного размера. Чтобы изменить это поведение, см. параметры scale и scale_units.

Значения по умолчанию дают слегка наклонённую стрелку; чтобы сделать головку треугольной, сделайте headaxislength равным headlength. Чтобы сделать стрелку более остроконечной, уменьшите headwidth или увеличьте headlength и headaxislength. Чтобы сделать головку меньше по отношению к стволу, уменьшите все параметры головки. Вероятно, лучше оставить minshaft без изменений.

linewidths и edgecolors можно использовать для настройки контуров стрелок.

Параметры:

Параметры:	X : 1D или 2D массив, последовательность, необязательно Координаты x положений стрелок Y : 1D или 2D массив, последовательность, необязательно Координаты y положений стрелок U : 1D или 2D массив или массив с пропусками, последовательность Компоненты x векторов стрелок V : 1D или 2D массив или массив с пропусками, последовательность Компоненты y векторов стрелок C : 1D или 2D массив, последовательность, необязательно Цвета стрелок units : [ ‘width’ \| ‘height’ \| ‘dots’ \| ‘inches’ \| ‘x’ \| ‘y’ \| ‘xy’ ] Размеры стрелок (кроме length) измеряются в единицах этого параметра. ‘width’ или ‘height’: ширина или высота оси ‘dots’ или ‘inches’: пиксели или дюймы, в зависимости от dpi изображения ‘x’, ‘y’ или ‘xy’: соответственно X, Y или в единицах данных Стрелки масштабируются по-разному в зависимости от единиц. Для ‘x’ или ‘y’ стрелки увеличиваются при приближении; для других единиц размер стрелок не зависит от масштабирования. Для ‘width’ или ‘height’ размер стрелок увеличивается с шириной и высотой осей соответственно при изменении размера окна; для ‘dots’ или ‘inches’ изменение размера не влияет на стрелки. angles : [ ‘uv’ \| ‘xy’ ], массив, необязательно Метод определения угла стрелок. По умолчанию ‘uv’. ‘uv’: отношение аспектов оси стрелок равно 1, поэтому если U==V, ориентация стрелки на графике составляет 45 градусов против часовой стрелки от горизонтальной оси (положительное значение вправо). ‘xy’: стрелки направлены от (x,y) к (x+u, y+v). Используйте это для построения поля градиента, например. Кроме того, произвольные углы могут быть заданы как массив значений в градусах, против часовой стрелки от горизонтальной оси. Примечание: инвертирование оси данных соответствующим образом инвертирует стрелки только при `angles='xy'`. scale : None, float, необязательно Количество единиц данных на единицу длины стрелки, например, м/с на единицу ширины графика; меньший параметр scale делает стрелку длиннее. По умолчанию None. Если None, используется простой алгоритм автоматического масштабирования, основанный на средней длине вектора и количестве векторов. Единица длины стрелки задаётся параметром scale_units scale_units : [ ‘width’ \| ‘height’ \| ‘dots’ \| ‘inches’ \| ‘x’ \| ‘y’ \| ‘xy’ ], None, необязательно Если параметр 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 : скаляр, необязательно Ширина ствола стрелки в единицах стрелки; значение по умолчанию зависит от выбора единиц, описанных выше, и количества векторов; типичное начальное значение составляет около 0,005 от ширины графика. headwidth : скаляр, необязательно Ширина головки как кратное ширине ствола, по умолчанию 3 headlength : скаляр, необязательно Длина головки как кратное ширине ствола, по умолчанию 5 headaxislength : скаляр, необязательно Длина головки в точке пересечения со стволом, по умолчанию 4,5 minshaft : скаляр, необязательно Длина, ниже которой стрелка масштабируется в единицах длины головки. Не устанавливайте это значение меньше 1, иначе маленькие стрелки будут выглядеть ужасно! По умолчанию 1 minlength : скаляр, необязательно Минимальная длина как кратное ширине ствола; если длина стрелки меньше этого значения, вместо этого отображается точка (шестиугольник) этого диаметра. По умолчанию 1. pivot : [ ‘tail’ \| ‘mid’ \| ‘middle’ \| ‘tip’ ], необязательно Часть стрелки, которая находится в точке сетки; стрелка вращается вокруг этой точки, отсюда и название pivot. color : [ цвет \| последовательность цветов ], необязательно Это синоним параметра facecolor для `PolyCollection`. Если C задан, color не имеет эффекта.

X : 1D или 2D массив, последовательность, необязательно

Координаты x положений стрелок

Y : 1D или 2D массив, последовательность, необязательно

Координаты y положений стрелок

U : 1D или 2D массив или массив с пропусками, последовательность

Компоненты x векторов стрелок

V : 1D или 2D массив или массив с пропусками, последовательность

Компоненты y векторов стрелок

C : 1D или 2D массив, последовательность, необязательно

Цвета стрелок

units : [ ‘width’ | ‘height’ | ‘dots’ | ‘inches’ | ‘x’ | ‘y’ | ‘xy’ ]

Размеры стрелок (кроме length) измеряются в единицах этого параметра.

‘width’ или ‘height’: ширина или высота оси

‘dots’ или ‘inches’: пиксели или дюймы, в зависимости от dpi изображения

‘x’, ‘y’ или ‘xy’: соответственно X, Y или в единицах данных

Стрелки масштабируются по-разному в зависимости от единиц. Для ‘x’ или ‘y’ стрелки увеличиваются при приближении; для других единиц размер стрелок не зависит от масштабирования. Для ‘width’ или ‘height’ размер стрелок увеличивается с шириной и высотой осей соответственно при изменении размера окна; для ‘dots’ или ‘inches’ изменение размера не влияет на стрелки.

angles : [ ‘uv’ | ‘xy’ ], массив, необязательно

Метод определения угла стрелок. По умолчанию ‘uv’.

‘uv’: отношение аспектов оси стрелок равно 1, поэтому если U*==*V, ориентация стрелки на графике составляет 45 градусов против часовой стрелки от горизонтальной оси (положительное значение вправо).

‘xy’: стрелки направлены от (x,y) к (x+u, y+v). Используйте это для построения поля градиента, например.

Кроме того, произвольные углы могут быть заданы как массив значений в градусах, против часовой стрелки от горизонтальной оси.

Примечание: инвертирование оси данных соответствующим образом инвертирует стрелки только при angles='xy'.

scale : None, float, необязательно

Количество единиц данных на единицу длины стрелки, например, м/с на единицу ширины графика; меньший параметр scale делает стрелку длиннее. По умолчанию None.

Если None, используется простой алгоритм автоматического масштабирования, основанный на средней длине вектора и количестве векторов. Единица длины стрелки задаётся параметром scale_units

Если параметр 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 : скаляр, необязательно

Ширина ствола стрелки в единицах стрелки; значение по умолчанию зависит от выбора единиц, описанных выше, и количества векторов; типичное начальное значение составляет около 0,005 от ширины графика.

headwidth : скаляр, необязательно

Ширина головки как кратное ширине ствола, по умолчанию 3

headlength : скаляр, необязательно

Длина головки как кратное ширине ствола, по умолчанию 5

headaxislength : скаляр, необязательно

Длина головки в точке пересечения со стволом, по умолчанию 4,5

minshaft : скаляр, необязательно

Длина, ниже которой стрелка масштабируется в единицах длины головки. Не устанавливайте это значение меньше 1, иначе маленькие стрелки будут выглядеть ужасно! По умолчанию 1

minlength : скаляр, необязательно

Минимальная длина как кратное ширине ствола; если длина стрелки меньше этого значения, вместо этого отображается точка (шестиугольник) этого диаметра. По умолчанию 1.

pivot : [ ‘tail’ | ‘mid’ | ‘middle’ | ‘tip’ ], необязательно

Часть стрелки, которая находится в точке сетки; стрелка вращается вокруг этой точки, отсюда и название pivot.

color : [ цвет | последовательность цветов ], необязательно

Это синоним параметра facecolor для PolyCollection. Если C задан, color не имеет эффекта.

См. также

quiverkey: Добавить ключ к графику quiver

Примечания

Дополнительные параметры PolyCollection:

Свойство	Описание
`agg_filter`	неизвестно
`alpha`	число с плавающей точкой или None
`animated`	[True \| False]
`antialiased` или antialiaseds	Булево значение или последовательность булевых значений
`array`	неизвестно
`clim`	последовательность из двух чисел с плавающей точкой
`clip_box`	экземпляр `matplotlib.transforms.Bbox`
`clip_on`	[True \| False]
`clip_path`	[ (`Path`, `Transform`) \| `Patch` \| None ]
`cmap`	цветовая карта или зарегистрированное имя цветовой карты
`color`	аргумент цвета matplotlib или последовательность кортежей rgba
`contains`	функция-обработчик
`edgecolor` или edgecolors	спецификация цвета matplotlib или последовательность спецификаций
`facecolor` или facecolors	спецификация цвета matplotlib или последовательность спецификаций
`figure`	экземпляр `matplotlib.figure.Figure`
`gid`	строка-идентификатор
`hatch`	[ ‘/’ \| ‘' \| ‘\|’ \| ‘-‘ \| ‘+’ \| ‘x’ \| ‘o’ \| ‘O’ \| ‘.’ \| ‘*’ ]
`label`	строка или любой вывод с преобразованием «%s»
`linestyle` или dashes или linestyles	[‘сплошная’ \| ‘штриховая’, ‘штрихпунктирная’, ‘пунктирная’ \| (смещение, последовательность вкл.-выкл.-штриха) \| `'-'` \| `'--'` \| `'-.'` \| `':'` \| `'None'` \| `' '` \| `''`]
`linewidth` или linewidths или lw	число с плавающей точкой или последовательность чисел с плавающей точкой
`norm`	неизвестно
`offset_position`	неизвестно
`offsets`	число с плавающей точкой или последовательность чисел с плавающей точкой
`path_effects`	неизвестно
`picker`	[None\|число с плавающей точкой\|булево значение\|функция-обработчик]
`pickradius`	неизвестно
`rasterized`	[True \| False \| None]
`sketch_params`	неизвестно
`snap`	неизвестно
`transform`	экземпляр `Transform`
`url`	строка URL
`urls`	неизвестно
`visible`	[True \| False]
`zorder`	любое число