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 или массив-подобный объект

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

heightfloat или массив-подобный объект

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

widthfloat или массив-подобный объект, по умолчанию: 0.8

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

bottomfloat или массив-подобный объект, по умолчанию: 0

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

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

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

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

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

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

BarContainer

Контейнер со всеми столбцами и, необязательно, с погрешностями.

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

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

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

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

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

linewidthfloat или массив-подобный объект, необязательно

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

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

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

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

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

xerr, yerrfloat или массив-подобный объект формы(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
mouseover	булево значение
path_effects	AbstractPathEffect
picker	None или булево значение или число с плавающей точкой или вызываемая функция
rasterized	булево значение
sketch_params	(масштаб: число с плавающей точкой, длина: число с плавающей точкой, случайность: число с плавающей точкой)
snap	булево значение или None
transform	Transform
url	строка
visible	булево значение
width	неизвестно
x	неизвестно
xy	(число с плавающей точкой, число с плавающей точкой)
y	неизвестно
zorder	число с плавающей точкой

См. также

barh

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

Примечания

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

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

Демонстрация таблицы

Демонстрация таблицы

Учебник pyplot

Учебник pyplot