matplotlib.axes.Axes.barh

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

Создаёт горизонтальную диаграмму столбцами.

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

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

Параметры:

yfloat или array-like

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

widthfloat или array-like

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

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

heightfloat или array-like, по умолчанию: 0.8

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

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

leftfloat или array-like, по умолчанию: 0

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

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

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

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

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

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

Возвращает:

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

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

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

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

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

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

linewidthfloat или array-like, необязательно

Ширина(ы) границы столбца. Если 0, не отображать границы.

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

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

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

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

xerr, yerrfloat или array-like формы(N,) или формы(2, N), необязательно

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

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

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

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

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

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

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

error_kwdict, необязательно

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

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

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

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

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

**kwargsRectangle свойства

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

См. также

bar: Построение столбчатой диаграммы.

Примечания

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

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

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

Горизонтальный столбиковый график

Дискретное распределение в виде горизонтального столбикового графика

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

Жизненный цикл графика

Анимация с использованием Matplotlib

matplotlib.axes.Axes.barh

Примечания

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

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