matplotlib.axes.Axes.barbs

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

Построение 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	неизвестно
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 или штрихи или стили линий	[‘сплошная’ | ‘пунктирная’, ‘пунктирная с точкой’, ‘точечная’ | (смещение, последовательность on-off-dash) | '-' | '--' | '-.' | ':' | '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	любое число

Примечание

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

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