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 Colormap или строка или None 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 или None offset_position неизвестно offsets массив-подобный объект (N, 2) или (2,) path_effects AbstractPathEffect picker None или логическое значение или вызываемый объект pickradius неизвестно rasterized логическое значение или None sketch_params (scale: число с плавающей точкой, length: число с плавающей точкой, randomness: число с плавающей точкой) snap логическое значение или None transform Transform url строка urls список строк или None visible логическое значение zorder число с плавающей точкой

Примечания

Примечание

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

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

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

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