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 (необязательно) задаёт цвет.

Все аргументы могут быть одномерными или двумерными. U, V, C могут быть массивами с пропускаемыми значениями, но в настоящее время не поддерживаются X, Y с пропускаемыми значениями.

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

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

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

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

Примечания

Примечание

В дополнение к вышеописанным аргументам, эта функция может принимать аргумент data. Если такой аргумент data задан, следующие аргументы заменяются на data[<arg>]:

• Все позиционные и все ключевые аргументы.

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

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

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