matplotlib.pyplot.bar

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

Создаёт гистограмму.

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

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

Параметры

xfloat или array-like

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

heightfloat или array-like

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

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

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

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

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

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

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

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

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

Возвращаемое значение

BarContainer

Контейнер, содержащий все столбцы и, необязательно, значения погрешностей.

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

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

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

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

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

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

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

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

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

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

См. также

barh

Построение горизонтальной гистограммы.

Примечания

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

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