matplotlib.axes.Axes.barh
-
Axes.barh(self, y, width, height=0.8, left=None, *, align='center', **kwargs)[source] -
Создать горизонтальную диаграмму столбцов.
Столбцы размещаются по оси y с заданным align. Их размеры задаются width и height. Горизонтальное основание — left (по умолчанию 0).
Каждый из y, width, height и left может быть скаляром, применяемым ко всем столбцам, или последовательностью длиной N, предоставляющей отдельное значение для каждого столбца.
Параметры: -
yscalar or array-like -
Координаты y столбцов. См. также align для выравнивания столбцов по координатам.
-
widthscalar or array-like -
Ширина(ы) столбцов.
-
heightsequence of scalars, optional, default: 0.8 -
Высота(ы) столбцов.
-
leftsequence of scalars -
Координаты x левых сторон столбцов (по умолчанию: 0).
-
align{'center', 'edge'}, optional, default: 'center' -
Выравнивание основания по координатам y*:
- 'center': Выровнять столбцы по центру по значениям y.
- 'edge': Выровнять нижние края столбцов по значениям y.
Для выравнивания столбцов по верхнему краю передайте отрицательное значение height и
align='edge'.
Возвращаемое значение: -
containerBarContainer -
Контейнер со всеми столбцами и, необязательно, с ошибками.
Другие параметры: -
colorscalar or array-like, optional -
Цвета граней столбцов.
-
edgecolorscalar or array-like, optional -
Цвета краев столбцов.
-
linewidthscalar or array-like, optional -
Ширина(ы) края столбца. Если 0, не отображать края.
-
tick_labelstr or array-like, optional -
Метки делений столбцов. По умолчанию: None (используются стандартные числовые метки).
-
xerr, yerrscalar or array-like of shape(N,) or shape(2, N), optional -
Если не
None, добавить горизонтальные/вертикальные ошибки к вершинам столбцов. Значения — +/- размеры относительно данных:- скаляр: симметричные +/- значения для всех столбцов
- форма (N,): симметричные +/- значения для каждого столбца
- форма (2, N): Отдельные - и + значения для каждого столбца. Первая строка содержит нижние ошибки, вторая — верхние.
- None: без ошибок. (по умолчанию)
См. Различные способы указания ошибок для примера использования
xerrиyerr. -
ecolorscalar or array-like, optional, default: 'black' -
Цвет линии ошибок.
-
capsizescalar, optional -
Длина колпачков ошибок в пунктах. По умолчанию: None, что примет значение из
rcParams["errorbar.capsize"](по умолчанию: 0.0). -
error_kwdict, optional -
Словарь kwargs, которые будут переданы методу
errorbar. Значения ecolor или capsize, определенные здесь, имеют приоритет над независимыми значениями kwargs. -
logbool, optional, default: False -
Если
True, установить логарифмический масштаб оси x.
См. также
-
bar - Построить вертикальную диаграмму столбцов.
Примечания
Необязательные аргументы color, edgecolor, linewidth, xerr и yerr могут быть скалярами или последовательностями длиной, равной количеству столбцов. Это позволяет использовать bar в качестве основы для столбчатых диаграмм или диаграмм свечей. Подробнее: xerr и yerr передаются напрямую в
errorbar(), поэтому они также могут иметь форму 2xN для независимого определения нижних и верхних ошибок.Другие необязательные значения kwargs:
-
Свойство Описание agg_filterфункция фильтра, которая принимает массив чисел с плавающей запятой (m, n, 3) и значение dpi, и возвращает массив чисел с плавающей запятой (m, n, 3) alphaчисло с плавающей запятой или None animatedлогическое значение antialiasedили aaнеизвестно capstyle{'butt', 'round', 'projecting'} clip_boxBboxclip_onлогическое значение clip_pathОбъект Patch или (Path, Transform) или None colorцвет containsвызываемая функция edgecolorили ecцвет или None или 'auto' facecolorили fcцвет или None figureFigurefillлогическое значение gidстрока hatch{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'} in_layoutлогическое значение joinstyle{'miter', 'round', 'bevel'} labelобъект linestyleили ls{'-', '--', '-.', ':', '', (смещение, последовательность вкл/выкл), ...} linewidthили lwчисло с плавающей запятой или None path_effectsAbstractPathEffectpickerNone или логическое значение или число с плавающей запятой или вызываемая функция rasterizedлогическое значение или None sketch_params(масштаб: число с плавающей запятой, длина: число с плавающей запятой, случайность: число с плавающей запятой) snapлогическое значение или None transformTransformurlстрока visibleлогическое значение zorderчисло с плавающей запятой
Примеры использования matplotlib.axes.Axes.barh
© 2012–2018 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/3.2.2/api/_as_gen/matplotlib.axes.Axes.barh.html