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
-
Высота(ы) столбцов.
- 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 (Используются числовые метки по умолчанию.)
- 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](если это не вызывает исключения). -
**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
bool
None или bool или float или вызываемый объект
bool
(масштаб: float, длина: float, случайность: float)
bool или None
строка
bool
неизвестно
неизвестно
(число с плавающей точкой, число с плавающей точкой)
неизвестно
число с плавающей точкой
-
См. также
barh-
Построить график горизонтальных столбцов.
Примечания
Для создания столбчатых диаграмм можно передать отдельные значения bottom для каждого столбца. См. Столбчатая диаграмма с наложением.
Примеры использования matplotlib.axes.Axes.bar
Особенности mpl_toolkits.axisartist.floating_axes
Создание 2D столбчатых диаграмм в разных плоскостях
Группированная столбчатая диаграмма с единицами измерения
© 2012–2023 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/3.6.0/api/_as_gen/matplotlib.axes.Axes.bar.html