matplotlib.axes.Axes.bar
- Axes.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строка или список строк, необязательно
-
Метки тиков столбцов. По умолчанию: None (Используются стандартные числовые метки).
- xerr, yerrfloat или array-like формы(N,) или формы(2, N), необязательно
-
Если не None, добавляет горизонтальные/вертикальные ошибки к кончикам столбцов. Значения - +/- размеры относительно данных:
- скаляр: симметричные +/- значения для всех столбцов
- форма(N,): симметричные +/- значения для каждого столбца
- форма(2, N): Отдельные - и + значения для каждого столбца. Первая строка содержит нижние ошибки, вторая строка содержит верхние ошибки.
- None: Нет ошибки. (По умолчанию)
См. Различные способы указания ошибок для примера использования
xerrиyerr. - ecolorцвет или список цветов, по умолчанию: 'черный'
-
Цвет линии ошибок.
-
capsizefloat, по умолчанию:
rcParams["errorbar.capsize"](по умолчанию:0.0) -
Длина колпачков ошибок в пунктах.
- error_kwсловарь, необязательно
-
Словарь kwargs, который должен быть передан методу
errorbar. Значения ecolor или capsize, определенные здесь, имеют приоритет над независимыми kwargs. - logbool, по умолчанию: False
-
Если True, задает логарифмический масштаб оси y.
- dataиндексируемый объект, необязательно
-
Если задано, все параметры также принимают строку
s, которая интерпретируется какdata[s](если это не вызывает исключение). -
**kwargs
Rectangleсвойства
-
Свойство
Описание
функция фильтра, которая принимает массив float (m, n, 3) и значение dpi, и возвращает массив (m, n, 3)
скаляр или None
неизвестно
bool
antialiasedили aabool или None
(левый, нижний, ширина, высота)
CapStyleили {'butt', 'projecting', 'round'}bool
Patch или (Path, Transform) или None
цвет
edgecolorили ecцвет или None
facecolorили fcцвет или None
bool
строка
{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
неизвестно
bool
JoinStyleили {'miter', 'round', 'bevel'}объект
linestyleили ls{'-', '--', '-.', ':', '', (смещение, последовательность включения-выключения), ...}
linewidthили lwчисло с плавающей точкой или None
None или bool или число с плавающей точкой или вызываемая функция
bool
(масштаб: число с плавающей точкой, длина: число с плавающей точкой, случайность: число с плавающей точкой)
bool или None
строка
bool
неизвестно
неизвестно
(число с плавающей точкой, число с плавающей точкой)
неизвестно
число с плавающей точкой
-
См. также
barh-
Построение горизонтального столбчатого графика.
Примечания
Столбчатые диаграммы можно создать, передавая отдельные значения bottom для каждого столбца. См. Столбчатую диаграмму со стопкой.
Примеры использования matplotlib.axes.Axes.bar
© 2012–2021 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/3.5.1/api/_as_gen/matplotlib.axes.Axes.bar.html