matplotlib.axes.Axes.errorbar

Axes.errorbar(self, 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: False Эти аргументы могут быть использованы для указания, что значение даёт только верхние/нижние пределы. В этом случае используется символ каретки для обозначения этого. lims-аргументы могут иметь тот же тип, что и xerr и yerr. Для использования пределов с инвертированными осями, необходимо вызвать set_xlim() или set_ylim() до вызова errorbar(). errorevery : positive integer, optional, default: 1 Подвыборка областей погрешности. Например, если errorevery=5, будут нарисованы области погрешности для каждой 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 функция фильтра, которая принимает массив float (m, n, 3) и значение dpi, и возвращает массив (m, n, 3) alpha float animated bool antialiased или aa bool clip_box Bbox clip_on bool clip_path [(Path, Transform) | Patch | None] color или c цвет contains вызываемый объект dash_capstyle {'butt', 'round', 'projecting'} dash_joinstyle {'miter', 'round', 'bevel'} dashes последовательность чисел с плавающей точкой (чернила включения/выключения в точках) или (None, None) 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 float marker стиль маркера markeredgecolor или mec цвет markeredgewidth или mew float markerfacecolor или mfc цвет markerfacecoloralt или mfcalt цвет markersize или ms float markevery None или int или (int, int) или slice или List[int] или float или (float, float) path_effects AbstractPathEffect picker float или вызываемый объект[[Artist, Event], Tuple[bool, dict]] pickradius float 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 float

Примечания

Примечание

Помимо вышеописанных аргументов, эта функция может принимать ключевой аргумент data. Если такой аргумент data указан, следующие аргументы заменяются на data[<arg>]:

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

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

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

Выбор пределов для элементов с ошибками