matplotlib.axes.Axes.bar

Axes.bar(*args, data=None, **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, определенные здесь, имеют приоритет над независимыми 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	bool
antialiased или aa	bool или None
capstyle	['butt' | 'round' | 'projecting']
clip_box	экземпляр Bbox
clip_on	bool
clip_path	[(Path, Transform) | Patch | None]
color	спецификация цвета matplotlib
contains	вызываемая функция
edgecolor или ec	спецификация цвета mpl, None, 'none' или 'auto'
facecolor или fc	спецификация цвета mpl или None по умолчанию, или 'none' для отсутствия цвета
figure	экземпляр Figure
fill	bool
gid	строка-идентификатор
hatch	['/' | '\' | '|' | '-' | '+' | 'x' | 'o' | 'O' | '.' | '*']
joinstyle	['miter' | 'round' | 'bevel']
label	объект
linestyle или ls	['solid' | 'dashed', 'dashdot', 'dotted' | (смещение, последовательность включений/выключений) | '-' | '--' | '-.' | ':' | 'None' | ' ' | '']
linewidth или lw	число с плавающей точкой или None по умолчанию
path_effects	AbstractPathEffect
picker	[None | bool | число с плавающей точкой | вызываемая функция]
rasterized	bool или None
sketch_params	(масштаб: float, длина: float, случайность: float)
snap	bool или None
transform	Transform
url	строка url
visible	bool
zorder	число с плавающей точкой

Примечание

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

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

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

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

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

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