matplotlib.pyplot.barbs

matplotlib.pyplot.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 or 2D array-like, optional Координаты 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 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 Объект Patch или (Path, Transform) или 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 {'screen', 'data'} 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.pyplot.barbs

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