matplotlib.axes.Axes.bar

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

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

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

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

Параметры:	x : sequence of scalars Координаты x столбцов. Смотрите также выравнивание для выравнивания столбцов по координатам. 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. Чтобы выровнять столбцы по правому краю, передайте отрицательную ширину и 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, определённые здесь, имеют приоритет над независимыми kwargs. 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:

Свойство	Описание
agg_filter	функция фильтра, которая принимает массив float (m, n, 3) и значение dpi, и возвращает массив (m, n, 3)
alpha	число с плавающей точкой или None
animated	логическое значение
antialiased	неизвестно
capstyle	{'butt', 'round', 'projecting'}
clip_box	Bbox
clip_on	логическое значение
clip_path	[(Path, Transform) | Patch | None]
color	цвет
contains	вызываемый объект
edgecolor	цвет или None или 'auto'
facecolor	цвет или None
figure	Figure
fill	логическое значение
gid	строка
hatch	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
in_layout	логическое значение
joinstyle	{'miter', 'round', 'bevel'}
label	объект
linestyle	{'-', '--', '-.', ':', '', (смещение, последовательность включения/выключения), ...}
linewidth	число с плавающей точкой или None для значения по умолчанию
path_effects	AbstractPathEffect
picker	None или логическое значение или число с плавающей точкой или вызываемый объект
rasterized	логическое значение или None
sketch_params	(масштаб: число с плавающей точкой, длина: число с плавающей точкой, случайность: число с плавающей точкой)
snap	логическое значение или None
transform	Transform
url	строка
visible	логическое значение
zorder	число с плавающей точкой

Примечание

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

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

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

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

Вложенные круговые диаграммы

Круговая диаграмма на полярной оси

Демонстрация штриховки