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

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

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 (Использовать стандартные числовые метки.)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

**kwargsRectangle свойства

Свойство	Описание
agg_filter	функция фильтра, которая принимает массив float (m, n, 3) и значение dpi, и возвращает массив (m, n, 3) и два смещения от нижнего левого угла изображения
alpha	скаляр или None
angle	неизвестно
animated	логическое значение
antialiased или aa	логическое значение или None
bounds	(левый, нижний, ширина, высота)
capstyle	CapStyle или {'butt', 'projecting', 'round'}
clip_box	Bbox
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

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

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

Горизонтальная диаграмма столбцов

Горизонтальная диаграмма столбцов

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

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

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

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