matplotlib.pyplot.barbs

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

Отображение 2D поля ветровых барок.

Вызов:

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

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

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

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

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

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

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

Параметры:

X, Y1D или 2D массив-подобный объект, необязательно

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

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

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

U, V1D или 2D массив-подобный объект

Компоненты x и y оси барбы.

C1D или 2D массив-подобный объект, необязательно

Численные данные, определяющие цвета барб с помощью цветовой схемы посредством 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_emptyбулево значение, по умолчанию: False

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

roundingбулево значение, по умолчанию: True

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

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

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

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

flip_barbбулево значение или массив булевых значений, по умолчанию: False

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

Одно значение применяется ко всем барбам. Индивидуальные барбы можно перевернуть, передав булевый массив такого же размера, как 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	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 или штрихи или 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	bool
zorder	float

Примечания

Примечание

Это обертка pyplot для axes.Axes.barbs.

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

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

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