matplotlib.pyplot.bar

matplotlib.pyplot.bar(*args, **kwargs) [source]

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

Варианты вызова:

bar(x, height, *, align='center', **kwargs)
bar(x, height, width, *, align='center', **kwargs)
bar(x, height, width, bottom, *, align='center', **kwargs)

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

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

Параметры:	`x : sequence of scalars` Координаты x столбцов. См. также align для выравнивания столбцов по координатам. `height : scalar or sequence of scalars` Высота(ы) столбцов. `width : scalar or array-like, optional` Ширина(ы) столбцов (по умолчанию: 0.8). `bottom : scalar or array-like, optional` Координата(ы) y нижней части столбцов (по умолчанию: 0). `align : {'center', 'edge'}, optional, default: 'center'` Выравнивание столбцов относительно координат x: 'center': Выравнивание по центру основания по координатам x. 'edge': Выравнивание левых краёв столбцов по координатам x. Для выравнивания столбцов по правому краю передайте отрицательное значение width и `align='edge'`.
Возвращает:	`container : BarContainer` Контейнер со всеми столбцами и, необязательно, с ошибками.
Другие параметры:	`color : scalar or array-like, optional` Цвета граней столбцов. `edgecolor : scalar or array-like, optional` Цвета краёв столбцов. `linewidth : scalar or array-like, optional` Ширина(ы) краёв столбцов. Если 0, края не рисуются. `tick_label : string or array-like, optional` Метки меток столбцов. По умолчанию: None (используются числовые метки по умолчанию). `xerr, yerr : scalar or array-like of shape(N,) or shape(2,N), optional` Если не None, добавляются горизонтальные/вертикальные погрешности к вершинам столбцов. Значения — +/- размеры относительно данных: скаляр: симметричные +/- значения для всех столбцов массив(N,): симметричные +/- значения для каждого столбца массив(2,N): Отдельные - и + значения для каждого столбца. Первая строка содержит нижние погрешности, вторая — верхние. None: Нет погрешностей. (По умолчанию) См. Различные способы задания погрешностей для примера использования `xerr` и `yerr`. `ecolor : scalar or array-like, optional, default: 'black'` Цвет линии погрешностей. `capsize : scalar, optional` Длина колпачков погрешностей в точках. По умолчанию: None, которое примет значение из `rcParams["errorbar.capsize"]`. `error_kw : dict, optional` Словарь kwargs, передаваемый методу `errorbar`. Значения ecolor или capsize, определённые здесь, имеют приоритет над независимыми значениями. `log : bool, 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	булево значение или None
`capstyle`	['butt' \| 'round' \| 'projecting']
`clip_box`	экземпляр `Bbox`
`clip_on`	булево значение
`clip_path`	[(`Path`, `Transform`) \| `Patch` \| None]
`color`	спецификация цвета matplotlib
`contains`	функция-вызов
`edgecolor` или ec	спецификация цвета mpl, None, 'none' или 'auto'
`facecolor` или fc	спецификация цвета mpl или None по умолчанию, или 'none' для отсутствия цвета
`figure`	экземпляр `Figure`
`fill`	булево значение
`gid`	строка-идентификатор
`hatch`	['/' \| '\' \| '\|' \| '-' \| '+' \| 'x' \| 'o' \| 'O' \| '.' \| '*']
`joinstyle`	['miter' \| 'round' \| 'bevel']
`label`	объект
`linestyle` или ls	['solid' \| 'dashed', 'dashdot', 'dotted' \| (смещение, последовательность on-off-штрихов) \| `'-'` \| `'--'` \| `'-.'` \| `':'` \| `'None'` \| `' '` \| `''`]
`linewidth` или lw	число с плавающей точкой или None по умолчанию
`path_effects`	`AbstractPathEffect`
`picker`	[None \| булево значение \| число с плавающей точкой \| функция-вызов]
`rasterized`	булево значение или None
`sketch_params`	(масштаб: число с плавающей точкой, длина: число с плавающей точкой, случайность: число с плавающей точкой)
`snap`	булево значение или None
`transform`	`Transform`
`url`	строка url
`visible`	булево значение
`zorder`	число с плавающей точкой

Примечание

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

Все аргументы со следующими именами: 'bottom', 'color', 'ecolor', 'edgecolor', 'height', 'left', 'linewidth', 'tick_label', 'width', 'x', 'xerr', 'y', 'yerr'.
Все позиционные аргументы.