matplotlib.axes.Axes.barh

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

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

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

Каждый из параметров y, width, height и left может быть скаляром, применяющимся ко всем столбцам, или последовательностью длины N, задающей отдельное значение для каждого столбца.

Параметры:	y : scalar or array-like Координаты y столбцов. Смотрите также align для выравнивания столбцов по координатам. width : scalar or array-like Ширина(ы) столбцов. height : sequence of scalars, optional, default: 0.8 Высота(ы) столбцов. left : sequence of scalars Координаты x левых границ столбцов (по умолчанию: 0). align : {'center', 'edge'}, optional, default: 'center' Выравнивание основания по координатам y*: 'center': Центрировать столбцы по позициям y. 'edge': Выровнять нижние края столбцов по позициям y. Для выравнивания столбцов по верхнему краю используйте отрицательное значение height и align='edge'.
Возвращаемое значение:	container : BarContainer Контейнер со всеми столбцами и, необязательно, ошибками.
Другие параметры:	color : scalar or array-like, optional Цвета граней столбцов. edgecolor : scalar or array-like, optional Цвета краёв столбцов. linewidth : scalar or array-like, optional Ширина края(ей) столбца(ов). Если 0, края не рисуются. tick_label : string or array-like, optional Метки шкал столбцов. По умолчанию: None (Используются числовые метки по умолчанию.) xerr, yerr : scalar or array-like of shape(N,) or shape(2,N), optional Если не None, добавляет горизонтальные/вертикальные ошибки к вершинам столбцов. Значения — это +/- размеры, относящиеся к данным: скаляр: симметричные +/- значения для всех столбцов форма (N,): симметричные +/- значения для каждого столбца форма (2,N): Отдельные - и + значения для каждого столбца. Первая строка содержит нижние ошибки, вторая — верхние. None: Нет ошибок. (по умолчанию) См. Различные способы задания ошибок для примера использования xerr и yerr. ecolor : scalar or array-like, optional, default: 'black' Цвет линии ошибок. capsize : scalar, optional Длина колпачков ошибок в пунктах. По умолчанию: None, что примет значение из rcParams["errorbar.capsize"]. error_kw : dict, optional Словарь kwargs, передаваемый методу errorbar. Значения ecolor или capsize, определённые здесь, имеют приоритет над независимыми параметрами. log : bool, optional, default: False Если True, установить логарифмическую шкалу оси x.

См. также

bar

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

Примечания

Необязательные аргументы color, edgecolor, linewidth, xerr и yerr могут быть скалярами или последовательностями длиной, равной числу столбцов. Это позволяет использовать bar в качестве основы для стопки столбцов или для диаграмм свечей. Подробно: xerr и yerr передаются непосредственно методу errorbar(), поэтому они также могут иметь форму 2xN для независимого задания нижних и верхних ошибок.

Другие необязательные параметры kwargs:

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

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

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