matplotlib.axes.Axes.barbs

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

Построение 2D поля ветровых стрелок.

Вызов:

barbs([X, Y], U, V, [C], **kwargs)

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

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

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

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

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

См. также https://en.wikipedia.org/wiki/Wind_barb.

Параметры:

X, YОдномерный или двумерный массив-подобный объект, необязательно

Координаты x и y местоположения стрелок. См. pivot для того, как стрелки выводятся на позиции x, y.

Если не заданы, они будут сгенерированы как равномерная сетка целых чисел на основе размеров U и V.

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

U, VОдномерный или двумерный массив-подобный объект

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

CОдномерный или двумерный массив-подобный объект, необязательно

Числовые данные, определяющие цвета стрелок с помощью цветовой схемы norm и cmap.

Не поддерживает явные цвета. Если вы хотите задать цвета напрямую, используйте barbcolor вместо этого.

lengthfloat, по умолчанию: 7

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

pivot{'tip', 'middle'} или float, по умолчанию: 'tip'

Часть стрелки, которая закреплена на сетке X, Y. Стрелка поворачивается вокруг этой точки. Это также может быть число, которое смещает начало стрелки на указанное количество пунктов от точки сетки.

barbcolorцвет или последовательность цветов

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

flagcolorцвет или последовательность цветов

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

sizesсловарь, необязательно

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

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

fill_emptybool, по умолчанию: False

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

roundingbool, по умолчанию: True

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

barb_incrementsсловарь, необязательно

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

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

flip_barbbool или массив bool, по умолчанию: False

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

Одно значение применяется ко всем стрелкам. Отдельные стрелки можно перевернуть, передав массив bool того же размера, что и U и V.

Возвращает:

barbsBarbs

Другие параметры:

dataиндексируемый объект, необязательно

Если задано, все параметры также принимают строку s, которая интерпретируется как data[s] (если это не вызывает исключение).

**kwargs

Стрелки можно дополнительно настроить, используя PolyCollection ключевые аргументы:

Свойство	Описание
agg_filter	функция фильтра, которая принимает массив float (m, n, 3) и значение dpi, и возвращает массив (m, n, 3) и два смещения от нижнего левого угла изображения
alpha	массив-подобный объект или скаляр или None
animated	bool
antialiased или aa или antialiaseds	bool или список bool
array	массив-подобный объект или None
capstyle	CapStyle или {'butt', 'projecting', 'round'}
clim	(vmin: float, vmax: float)
clip_box	BboxBase или None
clip_on	bool
clip_path	Patch или (Path, Transform) или None
cmap	Colormap или строка или None
color	цвет или список кортежей RGBA
edgecolor или ec или edgecolors	цвет или список цветов или 'face'
facecolor или facecolors или fc	цвет или список цветов
figure	Figure
gid	строка
hatch	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
in_layout	bool
joinstyle	JoinStyle или {'miter', 'round', 'bevel'}
label	объект
linestyle или dashes или linestyles или ls	строка или кортеж или список из них
linewidth или linewidths или lw	число с плавающей точкой или список чисел с плавающей точкой
mouseover	bool
norm	Normalize или строка или None
offset_transform или transOffset	Transform
offsets	(N, 2) или (2,) массив-подобный объект
path_effects	список AbstractPathEffect
paths	список массивов-подобных объектов
picker	None или bool или число с плавающей точкой или вызываемая функция
pickradius	число с плавающей точкой
rasterized	bool
sizes	numpy.ndarray или None
sketch_params	(scale: float, length: float, randomness: float)
snap	bool или None
transform	Transform
url	строка
urls	список строк или None

verts	список массивоподобных объектов
verts_and_codes	неизвестно
visible	логическое значение
zorder	вещественное число

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

Ветровые штили

Ветровые штили

barbs(X, Y, U, V)

barbs(X, Y, U, V)