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 с пропусками на данный момент не поддерживаются.

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

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

Наибольшее приращение задается треугольником (или «флагом»). После него идут сплошные линии (штрихи). Наименьшее приращение — это полулиния. Конечно, может быть не более одной полулинии. Если величина мала и требуется только одна полулиния, а нет сплошных линий или треугольников, то полулиния смещена от конца штриха, чтобы ее можно было легко отличить от штрихов с одной сплошной линией. Величина для показанной выше штриховой стрелки номинально составляет 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 массив NumPy 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.pyplot.barbs

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