matplotlib.pyplot.barbs

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

Построение 2D поля штриховых стрелок.

Вызов:

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

Где X, Y определяют расположение штриховых стрелок, U, V — направления штриховых стрелок, а C — необязательно задаёт цвет.

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

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

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

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

См. также 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_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 или str или 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: число с плавающей точкой, length: число с плавающей точкой, randomness: число с плавающей точкой) snap bool или None transform Transform url строка urls список строк или None visible bool zorder число с плавающей точкой

Примечания

Примечание

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

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

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