matplotlib.pyplot.barh
-
matplotlib.pyplot.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 могут быть скалярами или последовательностями длины, равной количеству столбцов. Это позволяет использовать bar в качестве основы для групповых столбчатых диаграмм или свечных графиков. Подробно: xerr и yerr передаются непосредственно в
errorbar(), поэтому они также могут иметь форму 2xN для независимого задания нижних и верхних ошибок.Другие необязательные kwargs:
-
Свойство Описание agg_filterфункция фильтра, которая принимает массив чисел с плавающей точкой (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строка идентификатора hatch['/' | '\' | '|' | '-' | '+' | 'x' | 'o' | 'O' | '.' | '*'] joinstyle['miter' | 'round' | 'bevel'] labelобъект linestyleили ls['solid' | 'dashed', 'dashdot', 'dotted' | (смещение, последовательность выкл-вкл штрихов) | '-'|'--'|'-.'|':'|'None'|' '|'']linewidthили lwчисло с плавающей точкой или None по умолчанию path_effectsAbstractPathEffectpicker[None | bool | число с плавающей точкой | вызываемая функция] 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.pyplot.barh.html