matplotlib.pyplot.barh

matplotlib.pyplot.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_kwсловарь, необязательно

Словарь ключевых аргументов, которые должны быть переданы методу 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	Bbox
clip_on	логическое значение
clip_path	фигура или (путь, преобразование) или 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.pyplot.barh

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

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

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

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

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

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