Spec-Zone.ru › Matplotlib 2.2

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

Spec-Zone.ru

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