matplotlib.axes.Axes.errorbar

Axes.errorbar(x, y, yerr=None, xerr=None, fmt='', ecolor=None, elinewidth=None, capsize=None, barsabove=False, lolims=False, uplims=False, xlolims=False, xuplims=False, errorevery=1, capthick=None, *, data=None, **kwargs)[source]

Строит график y в зависимости от x с линиями и/или маркерами, имеющими связанные с ними погрешности.

x, y определяют местоположение данных, xerr, yerr определяют размеры погрешностей. По умолчанию, это рисует маркеры/линии данных, а также погрешности. Используйте fmt='none', чтобы нарисовать погрешности без маркеров данных.

New in version 3.7: Крышки и линии погрешности рисуются в полярных координатах на полярных графиках.

Параметры:

x, yfloat или array-like

Положения данных.

xerr, yerrfloat или array-like, форма (N,) или форма (2, N), необязательно

Размеры погрешностей:

скаляр: Симметричные +/- значения для всех точек данных.
форма (N,): Симметричные +/- значения для каждой точки данных.
форма (2, N): Отдельные - и + значения для каждой полосы. Первый ряд содержит нижние погрешности, второй ряд содержит верхние погрешности.
None: Нет погрешности.

Все значения должны быть >= 0.

См. Разные способы задания погрешностей для примера использования xerr и yerr.

fmtстрока, по умолчанию: ''

Формат для точек данных/линий данных. См. plot для подробностей.

Используйте 'none' (регистронезависимо), чтобы построить погрешности без маркеров данных.

ecolorцвет, по умолчанию: None

Цвет линий погрешности. Если None, используется цвет линии, соединяющей маркеры.

elinewidthfloat, по умолчанию: None

Ширина линий погрешности. Если None, используется ширина линии текущего стиля.

capsizefloat, по умолчанию: rcParams["errorbar.capsize"] (по умолчанию: 0.0)

Длина колпачков погрешностей в точках.

capthickfloat, по умолчанию: None

Псевдоним для ключевого аргумента markeredgewidth (он же mew). Это более осмысленное название для свойства, которое контролирует толщину колпачка погрешности в точках. Для обратной совместимости, если заданы mew или markeredgewidth, они будут переопределять capthick. Это может измениться в будущих версиях.

barsabovebool, по умолчанию: False

Если True, то погрешности будут нарисованы над символами графика. По умолчанию - под.

lolims, uplims, xlolims, xuplimsbool, по умолчанию: False

Эти аргументы могут быть использованы для указания того, что значение дает только верхние/нижние пределы. В этом случае используется символ каретки, чтобы указать это. lims-аргументы могут быть скалярными или массивоподобными величинами той же длины, что и xerr и yerr. Для использования пределов с инвертированными осями необходимо вызвать set_xlim или set_ylim перед errorbar(). Обратите внимание на забавные названия параметров: например, установка lolims в True означает, что значение y является нижним пределом истинного значения, поэтому рисуется только стрелка, направленная вверх!

erroreveryint или (int, int), по умолчанию: 1

Рисует погрешности на подмножестве данных. errorevery =N рисует погрешности для точек (x[::N], y[::N]). errorevery =(start, N) рисует погрешности для точек (x[start::N], y[start::N]). Например, errorevery=(6, 3) добавляет погрешности к данным в (x[6], x[9], x[12], x[15], ...). Используется для предотвращения перекрытия погрешностей, когда два ряда используют одинаковые значения на оси x.

Возвращаемое значение:

ErrorbarContainer

Контейнер содержит:

plotline: экземпляр Line2D для маркеров и/или линии графика x, y.
caplines: Кортеж экземпляров Line2D колпачков погрешности.
barlinecols: Кортеж LineCollection с горизонтальными и вертикальными диапазонами погрешности.

Другие параметры:

dataиндексируемый объект, необязательно

Если задано, следующие параметры также принимают строку s, которая интерпретируется как data[s] (если это не вызывает исключения):

x, y, xerr, yerr

**kwargs

Все остальные ключевые аргументы передаются в вызов plot для рисования маркеров. Например, этот код создаёт большие красные квадраты с толстыми зелёными краями:

x, y, yerr = rand(3, 10)
errorbar(x, y, yerr, marker='s', mfc='red',
         mec='green', ms=20, mew=4)

где mfc, mec, ms и mew являются псевдонимами для более длинных имён свойств, markerfacecolor, markeredgecolor, markersize и markeredgewidth.

Действительными значениями kwargs для свойств маркера являются:

dashes
dash_capstyle
dash_joinstyle
drawstyle
fillstyle
linestyle
marker
markeredgecolor
markeredgewidth
markerfacecolor
markerfacecoloralt
markersize
markevery
solid_capstyle
solid_joinstyle

Обратитесь к соответствующему свойству Line2D для получения более подробной информации:

Свойство	Описание
`agg_filter`	функция фильтра, которая принимает массив чисел с плавающей точкой (m, n, 3) и значение dpi, а возвращает массив чисел с плавающей точкой (m, n, 3) и два смещения от нижнего левого угла изображения
`alpha`	скаляр или None
`animated`	булево значение
`antialiased` или aa	булево значение
`clip_box`	`Bbox`
`clip_on`	булево значение
`clip_path`	объект Patch или (объект Path, Transform) или None
`color` или c	цвет
`dash_capstyle`	`CapStyle` или {'butt', 'projecting', 'round'}
`dash_joinstyle`	`JoinStyle` или {'miter', 'round', 'bevel'}
`dashes`	последовательность чисел с плавающей точкой (печать включ./выкл. в точках) или (None, None)
`data`	массив (2, N) или два одномерных массива
`drawstyle` или ds	{'default', 'steps', 'steps-pre', 'steps-mid', 'steps-post'}, по умолчанию: 'default'
`figure`	`Figure`
`fillstyle`	{'full', 'left', 'right', 'bottom', 'top', 'none'}
`gapcolor`	цвет или None
`gid`	строка
`in_layout`	булево значение
`label`	объект
`linestyle` или ls	{'-', '--', '-.', ':', '', (смещение, последовательность включ./выкл.), ...}
`linewidth` или lw	число с плавающей точкой
`marker`	строка стиля маркера, `Path` или `MarkerStyle`
`markeredgecolor` или mec	цвет
`markeredgewidth` или mew	число с плавающей точкой
`markerfacecolor` или mfc	цвет
`markerfacecoloralt` или mfcalt	цвет
`markersize` или ms	число с плавающей точкой
`markevery`	None или целое число или (целое число, целое число) или срез или список целых чисел или число с плавающей точкой или (число с плавающей точкой, число с плавающей точкой) или список булевых значений
`mouseover`	булево значение
`path_effects`	`AbstractPathEffect`
`picker`	число с плавающей точкой или вызываемая функция [[Artist, Event], кортеж[bool, dict]]
`pickradius`	неизвестно
`rasterized`	булево значение
`sketch_params`	(масштаб: число с плавающей точкой, длина: число с плавающей точкой, случайность: число с плавающей точкой)
`snap`	булево значение или None
`solid_capstyle`	`CapStyle` или {'butt', 'projecting', 'round'}
`solid_joinstyle`	`JoinStyle` или {'miter', 'round', 'bevel'}
`transform`	неизвестно
`url`	строка
`visible`	булево значение
`xdata`	одномерный массив

`ydata`	Одномерный массив
`zorder`	вещественное число

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

Выбор пределов для столбцов с ошибками

Подвыборка столбцов с ошибками

Функция errorbar

Различные способы задания столбцов с ошибками

Включение верхних и нижних пределов в столбцы с ошибками

Создание прямоугольников из столбцов с ошибками с помощью PatchCollection

Вывод столбцов с ошибками на полярной оси

Демонстрация легенды

Parasite Simple2

3D столбцы с ошибками

Демонстрация логарифмических осей

errorbar(x, y, yerr, xerr)

matplotlib.axes.Axes.errorbar

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

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