matplotlib.pyplot.barh

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

Построение горизонтальной гистограммы.

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

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

Параметры:

yfloat или массив-подобный объект Координаты y столбцов. См. также align для выравнивания столбцов относительно координат. widthfloat или массив-подобный объект Ширина(ы) столбцов. heightfloat или массив-подобный объект, по умолчанию: 0.8 Высота(ы) столбцов. leftfloat или массив-подобный объект, по умолчанию: 0 Координаты x левых границ столбцов. align{'center', 'edge'}, по умолчанию: 'center' Выравнивание основания по координатам y*: 'center': Центрирование столбцов по координатам y. 'edge': Выравнивание нижних границ столбцов с координатами y. Для выравнивания столбцов по верхней границе используйте отрицательное значение height и align='edge'.

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

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

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

цветцвет или список цветов, необязательно Цвета граней столбцов. цвет_краяцвет или список цветов, необязательно Цвета краёв столбцов. ширина_линиивещественное число или массив-подобный объект, необязательно Ширина границ столбцов. Если 0, границы не рисуются. метки_деленийстрока или список строк, необязательно Метки делений столбцов. По умолчанию: None (используются числовые метки по умолчанию). xerr, yerrвещественное число или массив-подобный объект формы (N,) или (2, N), необязательно Если не None, добавляет горизонтальные/вертикальные погрешности к вершинам столбцов. Значения представляют собой +/- размеры относительно данных: скаляр: симметричные +/- значения для всех столбцов форма (N,): симметричные +/- значения для каждого столбца форма (2, N): отдельные значения - и + для каждого столбца. Первая строка содержит нижние погрешности, вторая строка — верхние погрешности. None: нет погрешностей. (по умолчанию) См. Различные способы задания погрешностей для примера использования xerr и yerr. ecolorцвет или список цветов, по умолчанию: 'чёрный' Цвет линий погрешностей. capsizeвещественное число, по умолчанию: rcParams["errorbar.capsize"] (по умолчанию: 0.0) Длина колпачков погрешностей в пунктах. error_kwсловарь, необязательно Словарь ключевых слов, которые будут переданы методу errorbar. Значения ecolor или capsize, определённые здесь, имеют приоритет над независимыми ключевыми словами. logбулево значение, по умолчанию: False Если True, устанавливает x-ось в логарифмическую шкалу. **kwargsRectangle свойства Свойство Описание agg_filter функция фильтра, которая принимает массив с плавающей точкой (m, n, 3) и значение dpi, и возвращает массив (m, n, 3) alpha скаляр или None animated булево значение antialiased или aa неизвестно capstyle CapStyle или {'butt', 'projecting', 'round'} clip_box Bbox clip_on булево значение clip_path Объект Patch или (Path, Transform) или None color цвет contains неизвестно edgecolor или ec цвет или None или 'auto' facecolor или fc цвет или None figure Figure fill булево значение gid строка hatch {'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'} in_layout булево значение joinstyle JoinStyle или {'miter', 'round', 'bevel'} label объект linestyle или ls {'-', '--', '-.', ':', '', (смещение, последовательность вкл/выкл), ...} linewidth или lw вещественное число или None path_effects AbstractPathEffect picker None или bool или вещественное число или вызываемая функция rasterized булево значение sketch_params (масштаб: вещественное число, длина: вещественное число, случайность: вещественное число) snap булево значение или None transform Transform url строка visible булево значение zorder вещественное число

См. также

bar

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

Примечания

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

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