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 с пропускаемыми значениями.

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

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

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

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

Параметры:

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

Возвращает:

barbs : Barbs

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

**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 [(Path, Transform) | Patch | 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 число с плавающей точкой или последовательность чисел с плавающей точкой 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

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