matplotlib.axes.Axes.barbs

Axes.barbs(self, *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.

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

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

Наибольшее приращение задается треугольником (или «флагом»). После этого следуют целые линии (штрихи). Наименьшее приращение — это половина линии. Конечно, максимум одна половина линии. Если величина невелика и требует только одной половины линии и ни одной целой линии или треугольника, половина линии смещается от конца штриха, чтобы её легко можно было отличить от штрихов с одной целой линией. Величина для показанного выше штриха в стандартных приращениях 50, 10 и 5 составляла бы приблизительно 65.

См. также https://en.wikipedia.org/wiki/Wind_barb.

Параметры:

X, Y1D or 2D array-like, optional Координаты 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, V1D or 2D array-like Компоненты x и y оси штриха. C1D or 2D array-like, optional Числовые данные, определяющие цвета штрихов путем сопоставления цветов с помощью norm и cmap. Это не поддерживает явные цвета. Если вы хотите задать цвета напрямую, используйте barbcolor вместо этого. lengthfloat, default: 7 Длина штриха в пунктах; другие части штриха масштабируются относительно этого. pivot{'tip', 'middle'} or float, default: 'tip' Часть стрелки, прикрепленная к сетке X, Y. Штрих вращается вокруг этой точки. Это также может быть число, смещающее начало штриха на заданное количество пунктов от точки сетки. barbcolorcolor or color sequence Цвет всех частей штриха, кроме флагов. Этот параметр аналогичен параметру edgecolor для полигонов, который можно использовать вместо этого. Однако этот параметр переопределит facecolor. flagcolorcolor or color sequence Цвет всех флагов на штрихе. Этот параметр аналогичен параметру facecolor для полигонов, который можно использовать вместо этого. Однако этот параметр переопределит facecolor. Если этот параметр не задан (и C тоже), то flagcolor будет установлен, чтобы соответствовать barbcolor, чтобы штрих имел однородный цвет. Если C задан, flagcolor не имеет эффекта. sizesdict, optional Словарь коэффициентов, определяющих отношение заданного элемента к длине штриха. Включать нужно только те значения, которые требуется переопределить. Эти элементы включают: 'spacing' - расстояние между элементами (флагами, полными/половинными штрихами) 'height' - высота (расстояние от оси до верха) флага или полного штриха 'width' - ширина флага, в два раза больше ширины полного штриха 'emptybarb' - радиус окружности, используемой для низких величин fill_emptybool, default: False Определяет, должны ли быть заполнены пустые штрихи (окружности) цветом флага. Если они не заполнены, центр прозрачен. roundingbool, default: True Определяет, должна ли величина вектора округляться при выделении компонентов штрихов. Если True, величина округляется до ближайшего кратного приращения половинного штриха. Если False, величина просто усекается до ближайшего меньшего кратного. barb_incrementsdict, optional Словарь приращений, задающий значения, которые нужно связать с разными частями штриха. Включать нужно только те значения, которые требуется переопределить. 'half' - половина штриха (Значение по умолчанию 5) 'full' - полный штрих (Значение по умолчанию 10) 'flag' - флаги (Значение по умолчанию 50) flip_barbbool or array-like of bool, default: False Определяет, должны ли линии и флаги указывать в противоположном направлении. Нормальное поведение — это то, что штрихи и линии указывают вправо (это происходит от штрихов ветра, у которых эти элементы указывают на низкое давление в Северном полушарии). Одно значение применяется ко всем штрихам. Отдельные штрихи можно перевернуть, передав массив bool такого же размера, как U и V.

Возвращает:

barbsBarbs

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

**kwargs Стрелки можно дополнительно настроить, используя ключевые аргументы PolyCollection: Свойство Описание agg_filter функция фильтра, которая принимает массив float (m, n, 3) и значение dpi, и возвращает массив (m, n, 3) alpha float или None animated bool antialiased или aa или antialiaseds bool или список bool array массив ndarray capstyle {'butt', 'round', 'projecting'} clim (vmin: float, vmax: float) clip_box Bbox clip_on bool clip_path Patch или (Path, Transform) или None cmap Colormap или str или None color цвет или список кортежей rgba contains неизвестно edgecolor или ec или edgecolors цвет или список цветов или 'face' facecolor или facecolors или fc цвет или список цветов figure Figure gid строка str hatch {'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'} in_layout bool joinstyle {'miter', 'round', 'bevel'} label объект linestyle или dashes или linestyles или ls строка str или кортеж или список linewidth или linewidths или lw float или список чисел с плавающей точкой norm Normalize или None offset_position неизвестно offsets массив-подобный объект (N, 2) или (2,) path_effects AbstractPathEffect picker None или bool или вызываемая функция pickradius неизвестно rasterized bool или None sketch_params (scale: float, length: float, randomness: float) snap bool или None transform Transform url строка str urls список строк str или None visible bool zorder число float

Примечания

Примечание

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

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

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

Демонстрация стрелок