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:

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

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

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

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

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

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

Примечание

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

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

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

Демонстрация штрихов