matplotlib.axes.Axes.barh

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

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

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

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

Параметры

yfloat или array-like

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

widthfloat или array-like

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

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

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

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

Координаты x левых границ столбцов.

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

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

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

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

Возвращаемое значение

BarContainer

Контейнер, содержащий все столбцы и, необязательно, погрешности.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

**kwargsRectangle свойства

Свойство	Описание
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	Bbox
clip_on	bool
clip_path	Объект Patch или (объект Path, преобразование) или None
color	цвет
edgecolor или ec	цвет или None
facecolor или fc	цвет или None
figure	Figure
fill	bool
gid	строка
hatch	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
height	неизвестно
in_layout	bool
joinstyle	JoinStyle или {'miter', 'round', 'bevel'}
label	объект
linestyle или ls	{'-', '--', '-.', ':', '', (смещение, последовательность включений-выключений), ...}
linewidth или lw	число с плавающей точкой или None
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.axes.Axes.barh