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 Аргумент цвета 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 функция фильтра, которая принимает массив с плавающей точкой (m, n, 3) и значение dpi, и возвращает массив (m, n, 3) alpha число с плавающей точкой animated логическое значение antialiased или aa логическое значение clip_box Bbox clip_on логическое значение 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 логическое значение label объект linestyle или ls {'-', '--', '-.', ':', '', (смещение, последовательность вкл/выкл), ...} linewidth или lw число с плавающей точкой marker стиль маркера markeredgecolor или mec цвет markeredgewidth или mew число с плавающей точкой markerfacecolor или mfc цвет markerfacecoloralt или mfcalt цвет markersize или ms число с плавающей точкой markevery None или целое число или (целое число, целое число) или срез или Список[целое число] или число с плавающей точкой или (число с плавающей точкой, число с плавающей точкой) 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

Выбор пределов для errorbar