matplotlib.axes.Axes.bar

Axes.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` Контейнер со всеми столбцами и, при необходимости, с ошибками.

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

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

logбулево значение, по умолчанию: False

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

**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 или 'авто'
`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 или булево значение или вещественное число или вызываемая функция
`rasterized`	булево значение
`sketch_params`	(масштаб: вещественное число, длина: вещественное число, случайность: вещественное число)
`snap`	булево значение или None
`transform`	`Transform`
`url`	строка
`visible`	булево значение
`zorder`	вещественное число

См. также

barh: Построить гистограмму с горизонтальными столбцами.

Примечания

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

Примечание

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

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