matplotlib.axes.Axes.bar

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

Создайте столбчатую диаграмму.

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

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

Параметры:

xfloat or array-like

Координаты x столбцов. Обратите внимание на параметр align для выравнивания столбцов по координатам.

heightfloat or array-like

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

widthfloat or array-like, default: 0.8

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

bottomfloat or array-like, default: 0

Координата(ы) y оснований столбцов.

align{'center', 'edge'}, default: 'center'

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

'center': Выравнивание по центру основания по значениям x.
'edge': Выравнивание левого края столбцов по значениям x.

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

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

BarContainer: Контейнер со всеми столбцами и, необязательно, с ошибками.

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

colorcolor or list of color, optional

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

edgecolorcolor or list of color, optional

Цвета краёв столбцов.

linewidthfloat or array-like, optional

Ширина грани(ей) столбца. Если 0, не отображать края.

tick_labelstr or list of str, optional

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

xerr, yerrfloat or array-like of shape(N,) or shape(2, N), optional

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

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

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

ecolorcolor or list of color, default: 'black'

Цвет линии ошибок.

capsizefloat, default: rcParams["errorbar.capsize"] (default: 0.0)

Длина колпачков ошибки в пунктах.

error_kwdict, optional

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

logbool, default: False

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

**kwargsRectangle properties

Свойство	Описание
`agg_filter`	Функция фильтра, которая принимает (m, n, 3) массив чисел с плавающей точкой и значение dpi, и возвращает (m, n, 3) массив
`alpha`	число с плавающей точкой или None
`animated`	булево значение
`antialiased` или aa	неизвестно
`capstyle`	{'butt', 'round', 'projecting'}
`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`	{'miter', 'round', 'bevel'}
`label`	объект
`linestyle` или ls	{'-', '--', '-.', ':', '', (смещение, последовательность включения/выключения), ...}
`linewidth` или lw	число с плавающей точкой или None
`path_effects`	`AbstractPathEffect`
`picker`	None или булево значение или вызываемый объект
`rasterized`	булево значение или None
`sketch_params`	(масштаб: float, длина: float, случайность: float)
`snap`	булево значение или None
`transform`	`Transform`
`url`	строка
`visible`	булево значение
`zorder`	число с плавающей точкой

См. также

barh: Построение горизонтальной столбчатой диаграммы.

Примечания

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

Примечание

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

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