matplotlib.axes.Axes.barbs

Axes.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 половины линии. Если величина мала и требуется только одна половина линии без целых линий или треугольников, половина линии смещена от конца барба, чтобы её можно было легко отличить от барбов с одной целой линией. Величина для показанного выше барба, по умолчанию, будет 65, используя стандартные приращения 50, 10 и 5.

См. также 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	функция фильтра, которая принимает массив 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 или str или None
color	цвет или список кортежей RGBA
edgecolor или ec или edgecolors	цвет или список цветов или 'face'
facecolor или facecolors или fc	цвет или список цветов
figure	Figure
gid	str
hatch	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
in_layout	bool
joinstyle	JoinStyle или {'miter', 'round', 'bevel'}
label	объект
linestyle или dashes или linestyles или ls	строка или кортеж или список кортежей
linewidth или linewidths или lw	float или список floats
mouseover	bool
norm	Normalize или строка или None
offset_transform или transOffset	Transform
offsets	(N, 2) или (2,) массив-подобный
path_effects	список AbstractPathEffect
paths	список массивов-подобных
picker	None или bool или float или вызываемый объект
pickradius	float
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.axes.Axes.barbs

Диаграммы ветра

Диаграммы ветра

barbs(X, Y, U, V)

barbs(X, Y, U, V)