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

Параметры

x, yfloat или массив

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

xerr, yerrfloat или массив, shape(N,) или shape(2, N), необязательно

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

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

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

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

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

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

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

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

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

elinewidthвещественное число, по умолчанию: None

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

capsizeвещественное число, по умолчанию: rcParams["errorbar.capsize"] (по умолчанию: 0.0)

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

capthickвещественное число, по умолчанию: 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 для свойств маркеров — это свойства Line2D.

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

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