matplotlib.pyplot.barbs

matplotlib.pyplot.barbs(*args, **kw)

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

Параметры ключевого слова:

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	неизвестно
alpha	число с плавающей точкой или None
animated	[True | False]
antialiased или antialiaseds	Булево значение или последовательность булевых значений
array	неизвестно
clim	последовательность из двух чисел с плавающей точкой
clip_box	экземпляр matplotlib.transforms.Bbox
clip_on	[True | False]
clip_path	[ (Path, Transform) | Patch | None ]
cmap	карта цветов или зарегистрированное имя карты цветов
color	аргумент цвета matplotlib или последовательность кортежей rgba
contains	функция вызова
edgecolor или edgecolors	спецификация цвета matplotlib или последовательность спецификаций
facecolor или facecolors	спецификация цвета matplotlib или последовательность спецификаций
figure	экземпляр matplotlib.figure.Figure
gid	строка-идентификатор
hatch	[ ‘/’ | ‘' | ‘|’ | ‘-‘ | ‘+’ | ‘x’ | ‘o’ | ‘O’ | ‘.’ | ‘*’ ]
label	строка или что-либо выводящееся с помощью преобразования ‘%s’
linestyle или штрихи или linestyles	[‘сплошная’ | ‘штриховая’, ‘штрихпунктирная’, ‘пунктирная’ | (смещение, последовательность вкл.-выкл-штрих) | '-' | '--' | '-.' | ':' | 'None' | ' ' | '']
linewidth или linewidths или lw	число с плавающей точкой или последовательность чисел с плавающей точкой
norm	неизвестно
offset_position	неизвестно
offsets	число с плавающей точкой или последовательность чисел с плавающей точкой
path_effects	неизвестно
picker	[None|число с плавающей точкой|булево значение|функция вызова]
pickradius	неизвестно
rasterized	[True | False | None]
sketch_params	неизвестно
snap	неизвестно
transform	экземпляр Transform
url	строка URL
urls	неизвестно
visible	[True | False]
zorder	любое число

Примечание

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

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