matplotlib.pyplot.barh

matplotlib.pyplot.barh(y, width, height=0.8, left=None, *, align='center', data=None, **kwargs)[source]

Создаёт график горизонтальных столбцов.

Столбцы размещаются по оси y с заданным align. Их размеры задаются параметрами width и height. Горизонтальная база — left (по умолчанию 0).

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

Параметры:

yfloat или массив-подобный объект

Координаты y столбцов. Смотрите также align для выравнивания столбцов по координатам.

widthfloat или массив-подобный объект

Ширина(ы) столбцов.

Обратите внимание, что если left имеет единицы измерения (например, datetime), width должен быть в единицах, представляющих разность от значения left (например, timedelta).

heightfloat или массив-подобный объект, по умолчанию: 0.8

Высота(ы) столбцов.

Обратите внимание, что если y имеет единицы измерения (например, datetime), то height должен быть в единицах, представляющих разность (например, timedelta) вокруг значений y.

leftfloat или массив-подобный объект, по умолчанию: 0

Координаты x левой стороны(й) столбцов.

Обратите внимание, что если left имеет единицы измерения, ось x получит Локатор и Форматтер, соответствующие единицам измерения (например, даты или категориальные значения).

align{'center', 'edge'}, по умолчанию: 'center'

Выравнивание основания по координатам y*:

• 'center': Центрировать столбцы по позициям y.
• 'edge': Выровнять нижние края столбцов с позициями y.

Чтобы выровнять столбцы по верхнему краю, передайте отрицательную height и align='edge'.

Возвращает:

BarContainer

Контейнер со всеми столбцами и, необязательно, с ошибками.

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

colorцвет или список цветов, необязательно

Цвета граней столбцов.

edgecolorцвет или список цветов, необязательно

Цвета краёв столбцов.

linewidthfloat или массив-подобный объект, необязательно

Ширина границы(й) столбца. Если 0, границы не рисуются.

tick_labelстрока или список строк, необязательно

Метки по оси столбцов. По умолчанию: None (Используются стандартные числовые метки).

labelстрока или список строк, необязательно

Единая метка прикрепляется к результатам BarContainer как метка для всего набора данных. Если передан список, он должен иметь ту же длину, что и y, и метки отдельных столбцов. Повторные метки не удаляются, и это приведёт к повторению записей меток, поэтому лучше всего использовать, когда столбцы также различаются по стилю (например, передавая список в color.)

xerr, yerrfloat или массив-подобный объект формы(N,) или формы(2, N), необязательно

Если не None, добавляет горизонтальные/вертикальные погрешности к вершинам столбцов. Значения — +/- размеры относительно данных:

• скаляр: симметричные +/- значения для всех столбцов
• форма(N,): симметричные +/- значения для каждого столбца
• форма(2, N): Отдельные - и + значения для каждого столбца. Первый ряд содержит нижние ошибки, второй ряд — верхние ошибки.
• None: Нет погрешностей. (по умолчанию)

Смотрите Различные способы задания погрешностей для примера использования xerr и yerr.

ecolorцвет или список цветов, по умолчанию: 'черный'

Цвет линии погрешностей.

capsizefloat, по умолчанию: rcParams["errorbar.capsize"] (по умолчанию: 0.0)

Длина колпачков погрешностей в точках.

error_kwсловарь, необязательно

Словарь ключевых слов, которые будут переданы методу errorbar. Значения ecolor или capsize, определённые здесь, имеют приоритет над независимыми ключевыми аргументами.

logbool, по умолчанию: False

Если True, установить масштаб оси x по логарифмической шкале.

dataиндексируемый объект, необязательно

Если указан, все параметры также принимают строку s, которая интерпретируется как data[s] (если это не вызывает исключение).

**kwargsсвойства Rectangle

Свойство	Описание
agg_filter	функция фильтра, которая принимает массив чисел с плавающей точкой (m, n, 3) и значение dpi, и возвращает массив чисел с плавающей точкой (m, n, 3) и два смещения от нижнего левого угла изображения
alpha	скаляр или None
angle	неизвестно
animated	bool
antialiased или aa	bool или None
bounds	(левый, нижний, ширина, высота)
capstyle	CapStyle или {'butt', 'projecting', 'round'}
clip_box	BboxBase или None
clip_on	bool
clip_path	Patch или (Path, Transform) или None
color	цвет
edgecolor или ec	цвет или None
facecolor или fc	цвет или None
figure	Figure
fill	bool
gid	str
hatch	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
height	неизвестно
in_layout	bool
joinstyle	JoinStyle или {'miter', 'round', 'bevel'}
label	объект
linestyle или ls	{'-', '--', '-.', ':', '', (смещение, последовательность включения-выключения), ...}
linewidth или lw	число с плавающей точкой или None
mouseover	bool
path_effects	список AbstractPathEffect
picker	None или bool или число с плавающей точкой или вызываемый объект
rasterized	bool
sketch_params	(масштаб: число с плавающей точкой, длина: число с плавающей точкой, случайность: число с плавающей точкой)
snap	bool или None
transform	Transform
url	строка
visible	bool
width	неизвестно
x	неизвестно
xy	(число с плавающей точкой, число с плавающей точкой)
y	неизвестно
zorder	число с плавающей точкой

См. также

bar

Построение вертикальной гистограммы.

Примечания

Гистограммы со стеками можно получить, передав отдельные значения left для каждой гистограммы. См. Дискретное распределение в виде горизонтальной гистограммы.

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

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

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

Дискретное распределение в виде горизонтальной гистограммы

Дискретное распределение в виде горизонтальной гистограммы

Построение нескольких гистограмм рядом

Построение нескольких гистограмм рядом