matplotlib.pyplot.barh

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

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

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

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

Параметры:	yscalar or array-like Координаты y столбцов. См. также align для выравнивания столбцов относительно координат. widthscalar or array-like Ширина(ы) столбцов. heightsequence of scalars, optional, default: 0.8 Высота(ы) столбцов. leftsequence of scalars Координаты x левых границ столбцов (по умолчанию: 0). align{'center', 'edge'}, optional, default: 'center' Выравнивание основания по координатам y: 'center': Центрировать столбцы по координатам y. 'edge': Выровнять нижние края столбцов с координатами y. Для выравнивания по верхнему краю передайте отрицательное значение height и align='edge'.
Возвращаемые значения:	containerBarContainer Контейнер, содержащий все столбцы и, необязательно, погрешности.
Дополнительные параметры:	colorscalar or array-like, optional Цвета граней столбцов. edgecolorscalar or array-like, optional Цвета краёв столбцов. linewidthscalar or array-like, optional Ширина края(ей) столбца(ов). Если 0, края не отображаются. tick_labelstr or array-like, optional Метки по оси столбцов. По умолчанию: None (Используются стандартные числовые метки). xerr, yerrscalar or array-like of shape(N,) or shape(2, N), optional Если не None, добавляются горизонтальные/вертикальные погрешности к вершинам столбцов. Значения — +/- размеры, относительные к данным: скаляр: симметричные +/- значения для всех столбцов форма(N,): симметричные +/- значения для каждого столбца форма(2, N): Отдельные значения - и + для каждого столбца. Первая строка содержит нижние погрешности, вторая — верхние. None: Без погрешности. (по умолчанию) См. Различные способы задания погрешностей для примера использования xerr и yerr. ecolorscalar or array-like, optional, default: 'black' Цвет линии погрешностей. capsizescalar, optional Длина колпачков погрешностей в пунктах. По умолчанию: None, что примет значение из rcParams["errorbar.capsize"] (по умолчанию: 0.0). error_kwdict, optional Словарь параметров, которые будут переданы методу errorbar. Значения ecolor или capsize, определённые здесь, имеют приоритет над независимыми параметрами. logbool, optional, default: False Если True, задайте масштаб оси x в логарифмическом виде.

См. также

bar

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

Замечания

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

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

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

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

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