matplotlib.pyplot.bar

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

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

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

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

Параметры:

xfloat or array-like

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

heightfloat or array-like

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

widthfloat or array-like, default: 0.8

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

bottomfloat or array-like, default: 0

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

align{'center', 'edge'}, default: 'center'

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

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

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

Возвращает:

BarContainer: Контейнер со всеми столбцами и, по желанию, ошибками.

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

colorcolor or list of color, optional

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

edgecolorcolor or list of color, optional

Цвета краёв столбцов.

linewidthfloat or array-like, optional

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

tick_labelstr or list of str, optional

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

xerr, yerrfloat or array-like of shape(N,) or shape(2, N), optional

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

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

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

ecolorcolor or list of color, default: 'black'

Цвет линии ошибок.

capsizefloat, default: rcParams["errorbar.capsize"] (default: 0.0)

Длина колпачков ошибки в пунктах.

error_kwdict, optional

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

logbool, default: False

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

**kwargsRectangle properties

Свойство	Описание
`agg_filter`	функция фильтра, которая принимает (m, n, 3) массив чисел с плавающей точкой и значение dpi, и возвращает (m, n, 3) массив
`alpha`	число с плавающей точкой или None
`animated`	bool
`antialiased` или aa	неизвестно
`capstyle`	{'butt', 'round', 'projecting'}
`clip_box`	`Bbox`
`clip_on`	bool
`clip_path`	Объект Patch или (Path, Transform) или 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`	(масштаб: число с плавающей точкой, длина: число с плавающей точкой, случайность: число с плавающей точкой)
`snap`	bool или None
`transform`	`Transform`
`url`	строка
`visible`	bool
`zorder`	число с плавающей точкой

См. также

barh: Построение горизонтальной столбчатой диаграммы.

Примечания

Уложенные столбцы могут быть получены путем передачи отдельных значений bottom для каждого столбца. См. Столбчатую диаграмму с уложенными столбцами.

Примечание

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

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