matplotlib.pyplot.barbs

matplotlib.pyplot.barbs(*args, data=None, **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 могут быть массивами с пропусками, но 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	функция фильтра, которая принимает массив чисел с плавающей точкой (m, n, 3) и значение dpi, и возвращает массив чисел с плавающей точкой (m, n, 3)
alpha	число с плавающей точкой или None
animated	логическое значение
antialiased	логическое значение или последовательность логических значений
array	массив NumPy
capstyle	{'butt', 'round', 'projecting'}
clim	последовательность из двух чисел с плавающей точкой; может быть переопределена в методах, имеющих параметры vmin и vmax.
clip_box	Bbox
clip_on	логическое значение
clip_path	[(Path, Transform) | Patch | None]
cmap	палитра цветов или зарегистрированное имя палитры
color	аргумент цвета matplotlib или последовательность кортежей rgba
contains	вызываемая функция
edgecolor	цвет или последовательность цветов
facecolor	цвет или последовательность цветов
figure	Figure
gid	строка
hatch	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
in_layout	логическое значение
joinstyle	{'miter', 'round', 'bevel'}
label	объект
linestyle	{'-', '--', '-.', ':', '', (смещение, последовательность включения/выключения), ...}
linewidth	число с плавающей точкой или последовательность чисел с плавающей точкой
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

Демонстрация штрихов