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, yfloat или массив-подобный

Позиции данных.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

barsaboveбулево, по умолчанию: False

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

lolims, uplims, xlolims, xuplimsбулево, по умолчанию: 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.

Допустимые параметры для свойств маркера:

• 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], кортеж[булево значение, словарь]]
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

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

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