matplotlib.axes.Axes.bar

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

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

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

Многие параметры могут принимать либо одно значение, применяемое ко всем столбцам, либо последовательность значений, по одному для каждого столбца.

Параметры:

xfloat или array-like

Координаты x столбцов. Также см. align для выравнивания столбцов относительно координат.

heightfloat или array-like

Высота(ы) столбцов.

Обратите внимание, что если bottom имеет единицы измерения (например, datetime), height должен быть в единицах, являющихся разностью от значения bottom (например, timedelta).

widthfloat или array-like, по умолчанию: 0.8

Ширина(ы) столбцов.

Обратите внимание, что если x имеет единицы измерения (например, datetime), то width должен быть в единицах, являющихся разностью (например, timedelta) вокруг значений x.

bottomfloat или array-like, по умолчанию: 0

Координата(ы) y нижней стороны(ы) столбцов.

Обратите внимание, что если bottom имеет единицы, то ось y получит Locator и Formatter, соответствующие единицам (например, даты или категориальные).

align{'center', 'edge'}, по умолчанию: 'center'

Выравнивание столбцов относительно координат x:

'center': Выравнивание основания по позициям x.
'edge': Выравнивание левых краев столбцов по позициям x.

Для выравнивания столбцов по правому краю передайте отрицательное значение width и align='edge'.

Возвращает:

BarContainer: Контейнер со всеми столбцами и (опционально) ошибками.

Другие параметры:

colorцвет или список цветов, необязательно

Цвета граней столбцов.

edgecolorцвет или список цветов, необязательно

Цвета границ столбцов.

linewidthfloat или array-like, необязательно

Ширина(ы) границы столбца(ов). Если 0, границы не рисуются.

tick_labelстрока или список строк, необязательно

Метки делений столбцов. По умолчанию: None (Используются стандартные числовые метки).

labelстрока или список строк, необязательно

Единая метка присваивается результирующему BarContainer в качестве метки для всего набора данных. Если предоставлен список, он должен иметь ту же длину, что и x, и маркирует отдельные столбцы. Повторные метки не удаляются и приведут к повторным записям меток, поэтому лучше всего использовать это, когда столбцы также отличаются стилем (например, передав список в color).

xerr, yerrfloat или array-like формы(N,) или формы(2, N), необязательно

Если не None, добавляются горизонтальные/вертикальные погрешности к вершинам столбцов. Значения — +/- размеры относительно данных:

скаляр: симметричные +/- значения для всех столбцов
форма(N,): симметричные +/- значения для каждого столбца
форма(2, N): Отдельные - и + значения для каждого столбца. Первый ряд содержит нижние погрешности, второй ряд — верхние.
None: Нет погрешностей. (По умолчанию)

См. Различные способы указания погрешностей для примера использования xerr и yerr.

ecolorцвет или список цветов, по умолчанию: 'черный'

Цвет линии погрешностей.

capsizefloat, по умолчанию: rcParams["errorbar.capsize"] (по умолчанию: 0.0)

Длина колпачков погрешностей в пунктах.

error_kwсловарь, необязательно

Словарь ключевых слов, которые будут переданы методу errorbar. Значения ecolor или capsize, определённые здесь, имеют приоритет над независимыми ключевыми словами.

logbool, по умолчанию: False

Если True, задаёт масштаб оси y в логарифмическом масштабе.

dataиндексируемый объект, необязательно

Если задан, все параметры также принимают строку s, которая интерпретируется как data[s] (если это не вызывает исключения).

**kwargsRectangle свойства

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