matplotlib.pyplot.quiver

matplotlib.pyplot.quiver(*args, **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 : [ цвет | последовательность цветов ], необязательно Это синоним параметра PolyCollection facecolor. Если 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 или штрихи или стили линий	[‘сплошная’ | ‘штриховая’, ‘штрихпунктирная’, ‘пунктирная’ | (смещение, последовательность вкл.-выкл.-штрих) | '-' | '--' | '-.' | ':' | '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	любое число

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

Демонстрация расширенных функций quiver и quiverkey