matplotlib.axes.Axes.barbs

Axes.barbs(*args, data=None, **kw)[source]

Отображение 2D поля штрихов.

Вызов:

barbs([X, Y], U, V, [C], **kw)

Где 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_emptybool, по умолчанию: False Определяет, следует ли заполнять пустые штрихи (окружности), которые нарисованы цветом флага. Если они не заполнены, центр прозрачен. roundingbool, по умолчанию: True Определяет, следует ли округлять величину вектора при распределении компонентов штриха. Если True, величина округляется до ближайшего кратного приращения половины штриха. Если False, величина просто усекается до ближайшего меньшего кратного. barb_incrementsсловарь, необязательно Словарь приращений, задающий значения, которые следует связать с разными частями штриха. Необходимо включать только те значения, которые требуется переопределить. 'half' - половины штрихов (По умолчанию 5) 'full' - целые штрихи (По умолчанию 10) 'flag' - флаги (по умолчанию 50) flip_barbbool или массив bool, по умолчанию: False Определяет, должны ли линии и флаги указывать в противоположную сторону от нормальной. Нормальное поведение — это то, что штрихи и линии указывают вправо (это происходит от того, что в штрихах ветра эти элементы указывают на низкое давление в Северном полушарии). Одно значение применяется ко всем штрихам. Отдельные штрихи можно перевернуть, передав массив bool такого же размера, как U и V.

Возвращает:

barbsBarbs

Другие параметры:

**kwargs Стрелки ветра можно дополнительно настроить, используя ключевые аргументы PolyCollection: Свойство Описание agg_filter функция фильтра, которая принимает массив float (m, n, 3) и значение dpi, и возвращает массив (m, n, 3) alpha подобный массиву или скаляр или None animated bool antialiased или aa или antialiaseds bool или список bool array ndarray или 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 contains неизвестно 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_position неизвестно offsets (N, 2) или (2,) массив-подобный объект path_effects AbstractPathEffect picker None или bool или число с плавающей точкой или вызываемая функция pickradius число с плавающей точкой rasterized bool sketch_params (scale: float, length: float, randomness: float) snap bool или None transform Transform url строка urls список строк или None visible bool zorder число с плавающей точкой

Примечания

Примечание

В дополнение к вышеописанным аргументам, эта функция может принимать ключевой аргумент data. Если такой аргумент data задан, каждый другой аргумент также может быть строкой s, которая интерпретируется как data[s] (если это не вызывает исключения).

Объекты, переданные в качестве data, должны поддерживать доступ к элементам (data[s]) и проверку на принадлежность (s in data).

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

Диаграммы стрелок ветра