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

x, yscalar or array-like

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

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

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

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

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

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

fmtstr, optional, default: ''

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

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

ecolorcolor, optional, default: None

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

elinewidthscalar, optional, default: None

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

capsizescalar, optional, default: None

Длина колпачков погрешности в пунктах. Если None, используется значение из rcParams["errorbar.capsize"] (по умолчанию: 0.0).

capthickscalar, optional, default: None

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

barsabovebool, optional, default: False

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

lolims, uplims, xlolims, xuplimsbool, optional, default: False

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

erroreveryint or (int, int), optional, 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.

Возвращает:

containerErrorbarContainer

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

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

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

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

Свойство	Описание
`agg_filter`	функция фильтра, которая принимает массив float (m, n, 3) и значение dpi и возвращает массив float (m, n, 3)
`alpha`	число с плавающей точкой или None
`animated`	булево значение
`antialiased` или aa	булево значение
`clip_box`	`Bbox`
`clip_on`	булево значение
`clip_path`	объект Patch или (Path, Transform) или 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`	стиль маркера
`markeredgecolor` или mec	цвет
`markeredgewidth` или mew	число с плавающей точкой
`markerfacecolor` или mfc	цвет
`markerfacecoloralt` или mfcalt	цвет
`markersize` или ms	число с плавающей точкой
`markevery`	None или целое число или (целое число, целое число) или срез или список целых чисел или число с плавающей точкой или (число с плавающей точкой, число с плавающей точкой)
`path_effects`	`AbstractPathEffect`
`picker`	число с плавающей точкой или вызываемая функция [[Artist, Event], Tuple[bool, dict]]
`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 предоставлен, следующие аргументы заменяются на data[<arg>]: