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

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

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

Примечания

Примечание

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

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

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

Выбор пределов для столбцов погрешности