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.

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

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

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

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_barbbool или массив bool, по умолчанию: False

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

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