matplotlib.pyplot.errorbar

matplotlib.pyplot.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, yчисло или массивоподобный объект

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

xerr, yerrчисло или массивоподобный объект, форма (N,) или форма (2, N), необязательно

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

• скаляр: Симметричные +/- значения для всех точек данных.
• форма (N,): Симметричные +/- значения для каждой точки данных.
• форма (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 является нижним пределом истинного значения, поэтому будет нарисована только стрелка, направленная вверх!

erroreveryцелое число или кортеж из двух целых чисел, по умолчанию: 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	логическое значение
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'}
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	вещественное число или вызываемый объект [[Artist, Event], tuple[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.pyplot.errorbar