matplotlib.axes.Axes.barbs

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

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	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	число с плавающей точкой

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