matplotlib.axes.Axes.barh
-
Axes.barh(*args, **kwargs)[source] -
Создать горизонтальную диаграмму столбцов.
Подписи:
bar(y, width, *, align='center', **kwargs) bar(y, width, height, *, align='center', **kwargs) bar(y, width, height, left, *, align='center', **kwargs)
Столбцы расположены по оси y с заданным align. Их размеры задаются width и height. Горизонтальная база — left (по умолчанию 0).
Каждый из y, width, height и left может быть скаляром, относящимся ко всем столбцам, или последовательностью длиной N, предоставляющей отдельное значение для каждого столбца.
Параметры: -
y : scalar or array-like -
Координаты y столбцов. См. также align для выравнивания столбцов по координатам.
-
width : scalar or array-like -
Ширина(ы) столбцов.
-
height : sequence of scalars, optional, default: 0.8 -
Высота(ы) столбцов.
-
left : sequence of scalars -
Координаты x левых сторон столбцов (по умолчанию: 0).
-
align : {'center', 'edge'}, optional, default: 'center' -
Выравнивание базы по координатам y*:
- 'center': Центрировать столбцы по значениям y.
- 'edge': Выровнять нижние края столбцов по значениям y.
Чтобы выровнять столбцы по верхнему краю, используйте отрицательную height и
align='edge'.
Возвращаемые значения: -
container : BarContainer -
Контейнер со всеми столбцами и, необязательно, с погрешностями.
Дополнительные параметры: -
color : scalar or array-like, optional -
Цвета граней столбцов.
-
edgecolor : scalar or array-like, optional -
Цвета краёв столбцов.
-
linewidth : scalar or array-like, optional -
Ширина(ы) границ столбца. Если 0, не отображать границы.
-
tick_label : string or array-like, optional -
Метки по оси столбцов. По умолчанию: None (использовать стандартные числовые метки.)
-
xerr, yerr : scalar or array-like of shape(N,) or shape(2,N), optional -
Если не
None, добавить горизонтальные / вертикальные погрешности к вершинам столбца. Значения — +/- размеры относительно данных:- скаляр: симметричные +/- значения для всех столбцов
- форма(N,): симметричные +/- значения для каждого столбца
-
- форма(2,N): Отдельные - и + значения для каждого столбца. Первая строка
- содержит нижние погрешности, вторая строка содержит верхние погрешности.
- None: Без погрешности. (по умолчанию)
См. Различные способы задания погрешностей для примера использования
xerrиyerr. -
ecolor : scalar or array-like, optional, default: 'black' -
Цвет линий погрешностей.
-
capsize : scalar, optional -
Длина колпачков погрешностей в пунктах. По умолчанию: None, что примет значение из
rcParams["errorbar.capsize"]. -
error_kw : dict, optional -
Словарь kwargs, который будет передан методу
errorbar. Значения ecolor или capsize, определенные здесь, имеют приоритет над независимыми kwargs. -
log : bool, optional, default: False -
Если
True, установить логарифмическую шкалу для оси x.
См. также
-
bar - Создать вертикальную диаграмму столбцов.
Примечания
Необязательные аргументы color, edgecolor, linewidth, xerr и yerr могут быть скалярами или последовательностями длины, равной числу столбцов. Это позволяет использовать бар в качестве основы для столбчатых диаграмм или диаграмм свечей. Подробности: xerr и yerr передаются непосредственно в
errorbar(), поэтому они также могут иметь форму 2xN для независимого задания нижних и верхних погрешностей.Другие необязательные kwargs:
-
Свойство Описание agg_filterфункция фильтра, которая принимает массив float (m, n, 3) и значение dpi, и возвращает массив (m, n, 3) alphaчисло с плавающей точкой или None animatedлогическое значение antialiasedили aaлогическое значение или None capstyle['butt' | 'round' | 'projecting'] clip_boxэкземпляр Bboxclip_onлогическое значение clip_path[( Path,Transform) |Patch| None]colorспецификация цвета matplotlib containsфункция-вызов edgecolorили ecспецификация цвета mpl, None, 'none' или 'auto' facecolorили fcспецификация цвета mpl или None для значения по умолчанию, или 'none' для отсутствия цвета figureэкземпляр Figurefillлогическое значение gidстрока id hatch['/' | '\' | '|' | '-' | '+' | 'x' | 'o' | 'O' | '.' | '*'] joinstyle['miter' | 'round' | 'bevel'] labelобъект linestyleили ls['solid' | 'dashed', 'dashdot', 'dotted' | (смещение, последовательность вкл/выкл штрихов) | '-'|'--'|'-.'|':'|'None'|' '|'']linewidthили lwчисло с плавающей точкой или None для значения по умолчанию path_effectsAbstractPathEffectpicker[None | логическое значение | число с плавающей точкой | вызываемая функция] rasterizedлогическое значение или None sketch_params(масштаб: число с плавающей точкой, длина: число с плавающей точкой, случайность: число с плавающей точкой) snapлогическое значение или None transformTransformurlстрока url visibleлогическое значение zorderчисло с плавающей точкой
© 2012–2018 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/2.2.3/api/_as_gen/matplotlib.axes.Axes.barh.html