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 в настоящее время не поддерживаются.

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

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

Наибольшее приращение задается треугольником (или «флагом»). За ним следуют сплошные линии (штрихи). Наименьшее приращение — это половина линии. Естественно, в любом случае максимум одна половина линии. Если величина мала и требуется только одна половина линии и нет сплошных линий или треугольников, половина линии смещена от конца штриха, чтобы ее можно было легко отличить от штрихов с одной сплошной линией. Величина показанного выше штриха в стандартном случае составляет 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 вместо этого.

lengthfloat, по умолчанию: 7

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

pivot{'tip', 'middle'} или float, по умолчанию: 'tip'

Часть стрелки, закреплённая на сетке X, Y. Штрих вращается вокруг этой точки. Это также может быть число, смещающее начало штриха на заданное количество пунктов от точки сетки.

barbcolorцвет или последовательность цветов

Цвет всех частей штриха, кроме флагов. Этот параметр аналогичен параметру edgecolor для многоугольников, который может быть использован вместо него. Однако этот параметр переопределит facecolor.

flagcolorцвет или последовательность цветов

Цвет любых флагов на штрихе. Этот параметр аналогичен параметру facecolor для многоугольников, который может быть использован вместо него. Однако этот параметр переопределит facecolor. Если он не задан (и C также нет), flagcolor будет установлен, чтобы соответствовать barbcolor, так что штрих будет одного цвета. Если C задан, flagcolor не имеет эффекта.

sizesdict, необязательно

Словарь коэффициентов, определяющих отношение заданного элемента к длине штриха. Включаются только те значения, которые необходимо переопределить. Эти элементы включают:

• 'spacing' - расстояние между элементами (флагами, полными/половинными штрихами)
• 'height' - высота (расстояние от ствола до вершины) флага или полного штриха
• 'width' - ширина флага, вдвое больше ширины полного штриха
• 'emptybarb' - радиус круга, используемого для малых величин

fill_emptybool, по умолчанию: False

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

roundingbool, по умолчанию: True

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

barb_incrementsdict, необязательно

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

• '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	число с плавающей точкой или список чисел с плавающей точкой
mouseover	bool
norm	Normalize или строка или None
offset_transform или transOffset	неизвестно
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	число с плавающей точкой

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

Ветровые стрелки

Ветровые стрелки

barbs(X, Y, U, V)

barbs(X, Y, U, V)