matplotlib.axes.Axes.errorbar

Axes.errorbar(self, 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', чтобы нарисовать области ошибок без маркеров данных.

Параметры:

Параметры:	`x, yfloat or array-like` Положения данных. `xerr, yerrfloat or array-like, shape(N,) or shape(2, N), optional` Размеры области ошибок: скаляр: Симметричные +/- значения для всех точек данных. форма(N,): Симметричные +/- значения для каждой точки данных. форма(2, N): Отдельные - и + значения для каждой области. Первый ряд содержит нижние ошибки, второй ряд содержит верхние ошибки. None: Нет области ошибок. Обратите внимание, что все массивы ошибок должны иметь положительные значения. См. Различные способы задания областей ошибок для примера использования `xerr` и `yerr`. `fmtstr, default: ''` Формат точек/линий данных. См. `plot` для подробностей. Используйте 'none' (регистронезависимо), чтобы нарисовать области ошибок без маркеров данных. `ecolorcolor, default: None` Цвет линий области ошибок. Если None, используется цвет линии, соединяющей маркеры. `elinewidthfloat, default: None` Ширина линий области ошибок. Если None, используется ширина линии текущего стиля. `capsizefloat, default: rcParams["errorbar.capsize"] (default: 0.0)` Длина колпачков области ошибок в пунктах. `capthickfloat, default: None` Псевдоним для ключевого аргумента markeredgewidth (а.к.а. mew). Это более понятное название свойства, которое управляет толщиной колпачков области ошибок в пунктах. Для обратной совместимости, если заданы mew или markeredgewidth, они переопределяют capthick. Это может измениться в будущих выпусках. `barsabovebool, default: False` Если True, области ошибок будут отображаться над символами графика. По умолчанию - под. `lolims, uplims, xlolims, xuplimsbool, default: False` Эти аргументы могут быть использованы для обозначения того, что значение даёт только верхние/нижние пределы. В этом случае используется символ каретки, чтобы указать это. lims-аргументы могут быть скалярами или массивоподобными объектами той же длины, что и xerr и yerr. Для использования пределов с инвертированными осями необходимо вызвать `set_xlim` или `set_ylim` перед `errorbar()`. Обратите внимание на сложные имена параметров: установка, например, lolims в True означает, что значение y является нижним пределом истинного значения, поэтому будет нарисован только восходящий стрелочный символ! `erroreveryint or (int, int), default: 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` с горизонтальными и вертикальными интервалами ошибок.

x, yfloat or array-like

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

xerr, yerrfloat or array-like, shape(N,) or shape(2, N), optional

Размеры области ошибок:

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

Обратите внимание, что все массивы ошибок должны иметь положительные значения.

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

fmtstr, default: ''

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

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

ecolorcolor, default: None

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

elinewidthfloat, default: None

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

capsizefloat, default: rcParams["errorbar.capsize"] (default: 0.0)

Длина колпачков области ошибок в пунктах.

capthickfloat, default: None

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

barsabovebool, default: False

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

lolims, uplims, xlolims, xuplimsbool, default: False

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

erroreveryint or (int, int), default: 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 с горизонтальными и вертикальными интервалами ошибок.

END_OF_DOCUMENT_MARKER

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

**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 для свойств маркеров — свойства Line2D:

Свойство	Описание
`agg_filter`	функция фильтра, которая принимает массив с плавающей точкой (m, n, 3) и значение dpi, и возвращает массив (m, n, 3)
`alpha`	вещественное число или None
`animated`	булево значение
`antialiased` или aa	булево значение
`clip_box`	`Bbox`
`clip_on`	булево значение
`clip_path`	фигура или (траектория, преобразование) или None
`color` или c	цвет
`contains`	неизвестно
`dash_capstyle`	{'butt', 'round', 'projecting'}
`dash_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'}
`gid`	строка
`in_layout`	булево значение
`label`	объект
`linestyle` или ls	{'-', '--', '-.', ':', '', (смещение, последовательность вкл./выкл.), ...}
`linewidth` или lw	вещественное число
`marker`	строка стиля маркера, `Path` или `MarkerStyle`
`markeredgecolor` или mec	цвет
`markeredgewidth` или mew	вещественное число
`markerfacecolor` или mfc	цвет
`markerfacecoloralt` или mfcalt	цвет
`markersize` или ms	вещественное число
`markevery`	None или целое число или (целое число, целое число) или срез или список целых чисел или вещественное число или (вещественное число, вещественное число) или список булевых значений
`path_effects`	`AbstractPathEffect`
`picker`	неизвестно
`pickradius`	вещественное число
`rasterized`	булево значение или None
`sketch_params`	(масштаб: вещественное число, длина: вещественное число, случайность: вещественное число)
`snap`	булево значение или None
`solid_capstyle`	{'butt', 'round', 'projecting'}
`solid_joinstyle`	{'miter', 'round', 'bevel'}
`transform`	`matplotlib.transforms.Transform`
`url`	строка
`visible`	булево значение
`xdata`	одномерный массив
`ydata`	одномерный массив
`zorder`	вещественное число

Примечания

Примечание

В дополнение к вышеописанным аргументам, эта функция может принять ключевой аргумент data. Если такой аргумент data задан, следующие аргументы также могут быть строками s, которые интерпретируются как data[s] (если это не вызывает исключение): x, y, xerr, yerr.

Объекты, переданные как data, должны поддерживать доступ к элементам (data[s]) и проверку на принадлежность (s in data).