matplotlib.axes.Axes.bar

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

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

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

Каждый из параметров x, height, width и bottom может быть скаляром, применяющимся ко всем столбцам, или последовательностью длиной N, задающей отдельное значение для каждого столбца.

Параметры:	`xsequence of scalars` Координаты x столбцов. См. также align для выравнивания столбцов относительно координат. `heightscalar or sequence of scalars` Высота(ы) столбцов. `widthscalar or array-like, optional` Ширина(ы) столбцов (по умолчанию: 0.8). `bottomscalar or array-like, optional` Координата(ы) y оснований столбцов (по умолчанию: 0). `align{'center', 'edge'}, optional, default: 'center'` Выравнивание столбцов относительно координат x: 'center': Центрирование основания на позициях x. 'edge': Выравнивание левых краёв столбцов с позициями x. Для выравнивания столбцов по правому краю передайте отрицательную width и `align='edge'`.
Возвращаемое значение:	`containerBarContainer` Контейнер, содержащий все столбцы и, необязательно, погрешности.
Другие параметры:	`colorscalar or array-like, optional` Цвета граней столбцов. `edgecolorscalar or array-like, optional` Цвета границ столбцов. `linewidthscalar or array-like, optional` Ширина границ столбца(ов). Если 0, границы не рисуются. `tick_labelstr or array-like, optional` Метки по оси x столбцов. По умолчанию: None (используются числовые метки по умолчанию). `xerr, yerrscalar or array-like of shape(N,) or shape(2, N), optional` Если не None, добавляет горизонтальные/вертикальные погрешности к вершинам столбцов. Значения — +/- размеры относительно данных: скаляр: симметричные +/- значения для всех столбцов массив длины N: симметричные +/- значения для каждого столбца массив формы 2xN: отдельные - и + значения для каждого столбца. Первый ряд содержит нижние погрешности, второй — верхние. None: Нет погрешностей. (По умолчанию) См. Различные способы задания погрешностей для примера использования `xerr` и `yerr`. `ecolorscalar or array-like, optional, default: 'black'` Цвет линий погрешностей. `capsizescalar, optional` Длина колпачков погрешности в пунктах. По умолчанию: None, что примет значение из `rcParams["errorbar.capsize"]` (по умолчанию: 0.0). `error_kwdict, optional` Словарь kwargs, передаваемый методу `errorbar`. Значения ecolor или capsize, определённые здесь, имеют приоритет над независимыми параметрами. `logbool, optional, default: False` Если True, устанавливает логарифмический масштаб по оси y. `orientation{'vertical', 'horizontal'}, optional` Только для внутреннего использования. Для горизонтальных столбчатых диаграмм используйте `barh`. По умолчанию: 'vertical'.

См. также

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

Примечания

Необязательные параметры color, edgecolor, linewidth, xerr и yerr могут быть скалярами или последовательностями длиной, равной количеству столбцов. Это позволяет использовать bar в качестве основы для столбчатых диаграмм или гистограмм. Подробно: xerr и yerr передаются напрямую в errorbar(), поэтому они также могут иметь форму 2xN для независимого задания нижних и верхних погрешностей.

Другие необязательные параметры kwargs:

END_OF_DOCUMENT_MARKER

Свойство	Описание
`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`	(масштаб: число с плавающей точкой, длина: число с плавающей точкой, случайность: число с плавающей точкой)
`snap`	булево значение или None
`transform`	`Transform`
`url`	строка
`visible`	булево значение
`zorder`	число с плавающей точкой

Примечание

В дополнение к вышеописанным аргументам, эта функция может принимать ключевой аргумент data. Если такой аргумент data задан, следующие аргументы заменяются на data[<arg>]: