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 : 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 Цвет линий погрешности. Если 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 : Все остальные ключевые аргументы передаются команде построения графика для маркеров. Например, этот код создаёт большие красные квадраты с толстыми зелёными границами: 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], Tuple[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).

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

Пределы Ошибок