matplotlib.pyplot.barbs

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

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

Вызов:

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

Где 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 вместо этого.

lengthвещественное число, по умолчанию: 7

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

pivot{'tip', 'middle'} или вещественное число, по умолчанию: '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	число с плавающей точкой или список чисел с плавающей точкой
norm	Normalize или None
offset_transform	Transform
offsets	(N, 2) или (2,) массив-подобный объект
path_effects	AbstractPathEffect
paths	список массив-подобных объектов
picker	None или bool или число с плавающей точкой или вызываемая функция
pickradius	число с плавающей точкой
rasterized	bool
sizes	массив NumPy или None
sketch_params	(scale: float, length: float, randomness: float)
snap	bool или None
transform	Transform
url	строка
urls	список строк или None
verts	список массив-подобных объектов
verts_and_codes	неизвестно
visible	bool
zorder	число с плавающей точкой