matplotlib.pyplot.bar

matplotlib.pyplot.bar(x, height, width=0.8, bottom=None, *, align='center', data=None, **kwargs)[source]

Создать гистограмму.

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

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

Параметры:

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

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

BarContainer Контейнер со всеми столбцами и, по желанию, с ошибками.

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

colorцвет или список цветов, необязательно Цвета граней столбцов. edgecolorцвет или список цветов, необязательно Цвета краёв столбцов. linewidthвещественное число или массив, необязательно Ширина границ столбцов. Если 0, границы не рисуются. tick_labelстрока или список строк, необязательно Метки для делений по оси. По умолчанию: None (используются числовые метки по умолчанию). xerr, yerrвещественное число или массив формы (N,) или (2, N), необязательно Если не None, добавляются горизонтальные/вертикальные погрешности к концам столбцов. Значения — это +/- размеры относительно данных: скаляр: симметричные +/- значения для всех столбцов форма (N,): симметричные +/- значения для каждого столбца форма (2, N): отдельные - и + значения для каждого столбца. Первая строка содержит нижние погрешности, вторая — верхние. None: нет погрешностей. (По умолчанию) См. Разные способы задания погрешностей для примера использования xerr и yerr. ecolorцвет или список цветов, по умолчанию: 'черный' Цвет линий погрешностей. capsizeвещественное число, по умолчанию: rcParams["errorbar.capsize"] (по умолчанию: 0.0) Длина колпачков погрешностей в пунктах. error_kwсловарь, необязательно Словарь kwargs, передаваемый методу errorbar. Значения ecolor или capsize, определённые здесь, имеют приоритет над независимыми параметрами. logbool, по умолчанию: False Если True, устанавливает логарифмический масштаб по оси y. **kwargsRectangle свойства Свойство Описание agg_filter функция фильтра, которая принимает (m, n, 3) массив float и значение dpi, и возвращает (m, n, 3) массив alpha скаляр или None animated bool antialiased или aa неизвестно capstyle CapStyle или {'butt', 'projecting', 'round'} 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 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 zorder вещественное число

См. также

barh

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

Примечания

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

Примечание

В дополнение к вышеописанным аргументам, эта функция может принимать ключевой аргумент data. Если такой аргумент data задан, все остальные аргументы также могут быть строками s, которые интерпретируются как data[s] (если это не вызывает исключение).

Объекты, переданные как data, должны поддерживать доступ к элементам (data[s]) и проверку на членство (s in data).

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

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

Учебник по Pyplot

Примеры графиков в Matplotlib