matplotlib.axes.Axes.bar

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

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

Столбцы размещаются по координатам 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` Метки по оси x. По умолчанию: 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:

END_OF_DOCUMENT_MARKER

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

Примечание

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