Spec-Zone.ru › Matplotlib 3.2

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_box Bbox
clip_on логическое значение
clip_path Объект Patch или (Path, Transform) или None
color цвет
contains вызываемая функция
edgecolor или ec цвет или None или 'auto'
facecolor или fc цвет или None
figure Figure
fill логическое значение
gid строка
hatch {'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
in_layout логическое значение
joinstyle {'miter', 'round', 'bevel'}
label объект
linestyle или ls {'-', '--', '-.', ':', '', (смещение, последовательность вкл/выкл), ...}
linewidth или lw число с плавающей запятой или None
path_effects AbstractPathEffect
picker None или логическое значение или число с плавающей запятой или вызываемая функция
rasterized логическое значение или None
sketch_params (масштаб: число с плавающей запятой, длина: число с плавающей запятой, случайность: число с плавающей запятой)
snap логическое значение или None
transform Transform
url строка
visible логическое значение
zorder число с плавающей запятой

Примеры использования matplotlib.axes.Axes.barh

Horizontal bar chart

Горизонтальная диаграмма столбцов

Discrete distribution as horizontal bar chart

Дискретное распределение как горизонтальная диаграмма столбцов

Producing multiple histograms side by side

Создание нескольких гистограмм рядом

The Lifecycle of a Plot

Жизненный цикл графика

© 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API