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	функция фильтра, которая принимает (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	Bbox
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	float или список float
mouseover	bool
norm	Normalize или строка или None
offset_transform или transOffset	неизвестно
offsets	(N, 2) или (2,) массив
path_effects	AbstractPathEffect
paths	список массивов
picker	None или bool или float или вызываемая функция
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	bool
zorder	float

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

Графики штилей ветра

Графики штилей ветра

barbs(X, Y, U, V)

barbs(X, Y, U, V)