matplotlib.pyplot.barbs

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

Построение 2-мерного поля стрелок-барбов.

Возможные варианты вызова:

barb(U, V, **kw)
barb(U, V, C, **kw)
barb(X, Y, U, V, **kw)
barb(X, Y, U, V, C, **kw)

Аргументы:

X, Y:

Координаты x и y положений барбов (по умолчанию — головка барба; см. параметр pivot)

U, V:

Компоненты x и y оси барба

C:

Массив, необязательный, для сопоставления цветов с барбами

Все аргументы могут быть одномерными или двумерными массивами или последовательностями. Если X и Y отсутствуют, они будут сгенерированы как равномерная сетка. Если U и V — двумерные массивы, а X и Y — одномерные, и если len(X) и len(Y) соответствуют размерностям столбцов и строк U, то X и Y будут расширены с помощью numpy.meshgrid().

U, V, C могут быть массивами с пропускаемыми значениями (masked arrays), но X и Y с пропускаемыми значениями (masked) в настоящее время не поддерживаются.

Ключевые параметры:

length:

Длина барба в точках; другие части барба масштабируются относительно этого значения. По умолчанию 7.

pivot: [ 'tip' | 'middle' | float ]

Часть стрелки, которая находится в точке сетки; стрелка вращается вокруг этой точки, отсюда и название pivot. По умолчанию 'tip'. Также может быть числом, смещающим начало барба на это количество точек от начала координат.

barbcolor: [ цвет | последовательность цветов ]

Устанавливает цвет всех частей барба, кроме флагов. Этот параметр аналогичен параметру edgecolor для многоугольников, который можно использовать вместо него. Однако этот параметр переопределит facecolor.

flagcolor: [ цвет | последовательность цветов ]

Устанавливает цвет флагов на барбе. Этот параметр аналогичен параметру facecolor для многоугольников, который можно использовать вместо него. Однако этот параметр переопределит facecolor. Если этот параметр не задан (и C тоже не задан), то flagcolor будет установлен в соответствии с barbcolor, чтобы барб имел одинаковый цвет. Если C задан, flagcolor не имеет эффекта.

sizes:

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

• 'spacing' - расстояние между элементами (флагами, полными/половинными барбами)
• 'height' - высота (расстояние от оси до вершины) флага или полной барбы
• 'width' - ширина флага, вдвое больше ширины полной барбы
• 'emptybarb' - радиус окружности, используемой для малых величин

fill_empty:

Флаг, указывающий, следует ли заполнять пустые барбы (окружности), которые отрисовываются, цветом флага. Если не заполнять, они будут отрисованы так, что цвет в центре не будет применён. По умолчанию False

rounding:

Флаг, указывающий, следует ли округлять величину вектора при распределении компонентов барба. Если True, величина округляется до ближайшего кратного половине приращения барбы. Если False, величина просто обрезается до ближайшего меньшего кратного. По умолчанию True

barb_increments:

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

• 'half' - половины барбы (По умолчанию 5)
• 'full' - полные барбы (По умолчанию 10)
• 'flag' - флаги (по умолчанию 50)

flip_barb:

Либо одиночный булевый флаг, либо массив булевых значений. Одиночный булевый флаг указывает, следует ли поворачивать линии и флаги в противоположном направлении для всех барбов. Массив (размер которого должен быть таким же, как у других массивов данных) указывает, следует ли поворачивать каждую отдельную барбу. Нормальное поведение — линии и флаги барбов указывают вправо (это происходит от того, что ветровые барбы направлены в сторону низкого давления в Северном полушарии). По умолчанию False

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

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

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

linewidths и edgecolors можно использовать для настройки барба. Дополнительные PolyCollection ключевые параметры:

Свойство	Описание
agg_filter	функция фильтра, которая принимает массив чисел с плавающей точкой (m, n, 3) и значение dpi, и возвращает массив чисел с плавающей точкой (m, n, 3)
alpha	число с плавающей точкой или None
animated	логическое значение
antialiased или antialiaseds	логическое значение или последовательность логических значений
array	массив NumPy
capstyle	неизвестно
clim	последовательность из двух чисел с плавающей точкой; может быть переопределён в методах, имеющих параметры vmin и vmax.
clip_box	экземпляр Bbox
clip_on	логическое значение
clip_path	[(Path, Transform) | Patch | None]
cmap	цветовая карта или зарегистрированное имя цветовой карты
color	аргумент цвета matplotlib или последовательность кортежей rgba
contains	вызываемая функция
edgecolor или edgecolors	спецификация цвета matplotlib или последовательность спецификаций
facecolor или facecolors	спецификация цвета matplotlib или последовательность спецификаций
figure	экземпляр Figure
gid	строка идентификатора
hatch	[ '/' | '\' | '|' | '-' | '+' | 'x' | 'o' | 'O' | '.' | '*' ]
joinstyle	неизвестно
label	объект
linestyle или штрихи или стили линий	['сплошная' | 'штриховая', 'штрихпунктирная', 'пунктирная' | (смещение, последовательность чередования on-off-dash) | '-' | '--' | '-.' | ':' | 'None' | ' ' | '']
linewidth или linewidths или lw	число с плавающей точкой или последовательность чисел с плавающей точкой
norm	Normalize
offset_position	[ 'экран' | 'данные' ]
offsets	число с плавающей точкой или последовательность чисел с плавающей точкой
path_effects	AbstractPathEffect
picker	[None | логическое значение | число с плавающей точкой | вызываемая функция]
pickradius	расстояние в пунктах
rasterized	логическое значение или None
sketch_params	(масштаб: число с плавающей точкой, длина: число с плавающей точкой, случайность: число с плавающей точкой)
snap	логическое значение или None
transform	Transform
url	строка URL
urls	Список строк или None
visible	логическое значение
zorder	число с плавающей точкой

Примечание

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

• Все позиционные и все ключевые аргументы.

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

Пример использования баров