matplotlib.pyplot.barbs

matplotlib.pyplot.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	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	bool

zorder

вещественное число

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

Графики ветровых стрелок

Графики ветровых стрелок