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, y : scalar or array-like Положение данных. xerr, yerr : scalar or array-like, shape(N,) or shape(2,N), optional Размеры отрезков погрешности: скаляр: Симметричные +/- значения для всех точек данных. форма (N,): Симметричные +/- значения для каждой точки данных. форма (2,N): Отдельные - и + значения для каждого отрезка. Первая строка содержит нижние ошибки, вторая строка содержит верхние ошибки. None: Нет отрезков погрешности. См. Различные способы задания отрезков погрешности для примера использования xerr и yerr. fmt : plot format string, optional, default: '' Формат точек данных / линий данных. См. plot для деталей. Используйте 'none' (регистронезависимо) для построения только отрезков погрешности без маркеров данных. ecolor : mpl color, optional, default: None Аргумент цвета matplotlib, задающий цвет линий отрезков погрешности. Если None, используется цвет линии, соединяющей маркеры. elinewidth : scalar, optional, default: None Толщина линий отрезков погрешности. Если None, используется толщина линии текущего стиля. capsize : scalar, optional, default: None Длина наконечников отрезков погрешности в точках. Если None, используется значение из rcParams["errorbar.capsize"]. capthick : scalar, optional, default: None Псевдоним для ключевого аргумента markeredgewidth (также известен как mew). Это более осмысленное название свойства, которое управляет толщиной наконечников отрезков погрешности в точках. Для обратной совместимости, если заданы mew или markeredgewidth, они переопределят capthick. В будущих выпусках это может измениться. barsabove : bool, optional, default: False Если True, отрезки погрешности будут отображаться над символами графика. По умолчанию - под ними. lolims, uplims, xlolims, xuplims : bool, optional, default: None Эти аргументы могут использоваться для указания того, что значение дает только верхние/нижние пределы. В этом случае используется символ каретки для обозначения этого. lims-аргументы могут быть такого же типа, как xerr и yerr. Для использования пределов с инвертированными осями необходимо вызвать set_xlim() или set_ylim() перед вызовом errorbar(). errorevery : positive integer, optional, default: 1 Подвыборка отрезков погрешности. Например, если errorevery=5, отрезки погрешности для каждой пятой точки данных будут построены. Сам график данных все равно отображает все точки данных.

Возвращает:

container : 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 для свойств маркеров — это Lines2D свойства: Свойство Описание agg_filter функция фильтра, которая принимает массив чисел с плавающей точкой (m, n, 3) и значение dpi, и возвращает массив чисел с плавающей точкой (m, n, 3) alpha вещественное число animated логическое значение antialiased логическое значение clip_box Bbox clip_on логическое значение clip_path [(Path, Transform) | Patch | None] color цвет contains вызываемый объект dash_capstyle {'butt', 'round', 'projecting'} dash_joinstyle {'miter', 'round', 'bevel'} dashes последовательность чисел с плавающей точкой (чернила включения/выключения в точках) или (None, None) drawstyle {'default', 'steps', 'steps-pre', 'steps-mid', 'steps-post'} figure Figure fillstyle {'full', 'left', 'right', 'bottom', 'top', 'none'} gid строка in_layout логическое значение label объект linestyle {'-', '--', '-.', ':', '', (смещение, последовательность включения/выключения), ...} linewidth вещественное число marker неизвестно markeredgecolor цвет markeredgewidth вещественное число markerfacecolor цвет markerfacecoloralt цвет markersize вещественное число markevery неизвестно path_effects AbstractPathEffect picker вещественное число или вызываемый объект [[Artist, Event], Кортеж[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>]:

• Все аргументы с именами 'x', 'xerr', 'y', 'yerr'.

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