matplotlib.axes.Axes.barbs

Axes.barbs(*args, data=None, **kw) [source]

Отобразить 2-мерное поле стрелок.

Возможные варианты вызова:

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

Аргументы:

X, Y:

Координаты x и y расположения стрелок (по умолчанию — головка стрелки; см. параметр pivot)

U, V:

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

C:

Необязательный массив для задания цвета стрелок

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

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

Параметры:

length:

Длина стрелки в пунктах; остальные части стрелки масштабируются относительно этого значения. По умолчанию 7.

pivot: [ 'tip' | 'middle' | float ]

Часть стрелки, которая находится в точке сетки; стрелка вращается вокруг этой точки, отсюда и название pivot. По умолчанию 'tip'. Также может быть числом, которое сдвигает начало стрелки на указанное количество пунктов от начала координат.

barbcolor: [ цвет | последовательность цветов ]

Задает цвет всех частей стрелки, кроме флагов. Этот параметр аналогичен параметру edgecolor для многоугольников, который можно использовать вместо него. Однако этот параметр переопределит параметр facecolor.

flagcolor: [ цвет | последовательность цветов ]

Задает цвет флагов на стрелке. Этот параметр аналогичен параметру facecolor для многоугольников, который можно использовать вместо него. Однако этот параметр переопределит параметр facecolor. Если этот параметр не задан (и C тоже), то flagcolor будет установлен в соответствии с barbcolor, чтобы стрелка имела однородный цвет. Если C задан, то flagcolor не имеет эффекта.

sizes:

Словарь коэффициентов, определяющих отношение заданного элемента к длине стрелки. Необходимо включать только те значения, которые необходимо переопределить. Эти элементы включают:

• 'spacing' - расстояние между элементами (флагами, полными/полустрелками)
• 'height' - высота (расстояние от оси до вершины) флага или полной стрелки
• 'width' - ширина флага, вдвое больше ширины полной стрелки
• 'emptybarb' - радиус круга, используемого для малых значений

fill_empty:

Флаг, определяющий, должны ли заполняться пустые стрелки (круги) цветом флага. Если они не заполнены, они будут нарисованы без применения цвета к центру. По умолчанию False

rounding:

Флаг, указывающий, следует ли округлять величину вектора при распределении компонентов стрелки. Если True, величина округляется до ближайшего кратного половины шага. Если False, величина просто усекается до ближайшего меньшего кратного. По умолчанию True

barb_increments:

Словарь приращений, определяющий значения, которые необходимо связать с разными частями стрелки. Необходимо включать только те значения, которые необходимо переопределить.

• 'half' - полустрелки (по умолчанию 5)
• 'full' - полные стрелки (по умолчанию 10)
• 'flag' - флаги (по умолчанию 50)

flip_barb:

Либо одиночный логический флаг, либо массив логических значений. Одиночный логический флаг указывает, должны ли линии и флаги указывать направление, противоположное обычному, для всех стрелок. Массив (который должен иметь тот же размер, что и другие массивы данных) указывает, следует ли переворачивать каждую отдельную стрелку. Нормальное поведение — стрелки и линии указывают вправо (происходит от того, что стрелки ветра указывают в направлении низкого давления в Северном полушарии). По умолчанию False

Стрелки традиционно используются в метеорологии для отображения скорости и направления ветра, но технически могут использоваться для отображения любых двумерных векторных величин. В отличие от стрелок, которые указывают величину вектора по длине стрелки, стрелки с отметками дают более количественную информацию о величине вектора, помещая наклонные линии или треугольник для различных приращений величины, как показано ниже:

:     /\    \\
:    /  \    \\
:   /    \    \    \\
:  /      \    \    \\
: ------------------------------

Наибольшее приращение задается треугольником (или "флагом"). После них идут полные линии (стрелки). Наименьшее приращение — половинная линия. Конечно, всегда есть не более одной полулинии. Если величина мала и требует только одной полулинии и нет полных линий или треугольников, полулиния смещается от конца стрелки, чтобы ее можно было легко отличить от стрелок с одной полной линией. Величина для показанной выше стрелки номинально равна 65, используя стандартные приращения 50, 10 и 5.

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

Свойство	Описание
agg_filter	функция фильтра, которая принимает массив float (m, n, 3) и значение dpi, и возвращает массив (m, n, 3)
alpha	float или None
animated	bool
antialiased	bool или последовательность bool
array	ndarray
capstyle	{'butt', 'round', 'projecting'}
clim	последовательность длиной 2 из чисел с плавающей точкой; может быть переопределён в методах, имеющих параметры vmin и vmax
clip_box	Bbox
clip_on	bool
clip_path	[(Path, Transform) | Patch | None]
cmap	цветовая карта или зарегистрированное имя цветовой карты
color	аргумент цвета matplotlib или последовательность кортежей rgba
contains	вызываемый объект
edgecolor	цвет или последовательность цветов
facecolor	цвет или последовательность цветов
figure	Figure
gid	строка
hatch	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
in_layout	bool
joinstyle	{'miter', 'round', 'bevel'}
label	объект
linestyle	{'-', '--', '-.', ':', '', (смещение, последовательность вкл-выкл), ...}
linewidth	число с плавающей точкой или последовательность чисел с плавающей точкой
norm	Normalize
offset_position	{'screen', 'data'}
offsets	число с плавающей точкой или последовательность чисел с плавающей точкой
path_effects	AbstractPathEffect
picker	None или bool или число с плавающей точкой или вызываемый объект
pickradius	неизвестно
rasterized	bool или None
sketch_params	(масштаб: float, длина: float, случайность: float)
snap	bool или None
transform	Transform
url	строка
urls	Список[строка] или None
visible	bool
zorder	число с плавающей точкой

Примечание

Помимо описанных выше аргументов, эта функция может принимать аргумент data. Если такой аргумент data задан, следующие аргументы заменяются на data[<arg>]:

• Все позиционные и все именованные аргументы.

Объекты, переданные как data, должны поддерживать доступ по индексу (data[<arg>]) и проверку на вхождение (<arg> in data).

Примеры использования matplotlib.axes.Axes.barbs

Демонстрация стрелок ветра