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, yscalar or array-like Положения данных. xerr, yerrscalar or array-like, shape(N,) or shape(2, N), optional Размеры полос погрешностей: скаляр: Симметричные значения +/- для всех точек данных. форма (N,): Симметричные значения +/- для каждой точки данных. форма (2, N): Отдельные значения - и + для каждой полосы. Первая строка содержит нижние погрешности, вторая строка содержит верхние погрешности. None: Нет полос погрешностей. Обратите внимание, что все массивы ошибок должны иметь положительные значения. См. Различные способы задания полос погрешностей для примера использования xerr и yerr. fmtstr, optional, default: '' Формат для точек данных / линий данных. См. plot для подробностей. Используйте 'none' (регистр не учитывается), чтобы нарисовать полосы погрешностей без маркеров данных. ecolorcolor, optional, default: None Цвет линий полос погрешностей. Если None, используется цвет линии, соединяющей маркеры. elinewidthscalar, optional, default: None Толщина линий полос погрешностей. Если None, используется толщина линии текущего стиля. capsizescalar, optional, default: None Длина колпачков полос погрешностей в пунктах. Если None, используется значение из rcParams["errorbar.capsize"] (по умолчанию: 0,0). capthickscalar, optional, default: None Псевдоним для ключевого аргумента markeredgewidth (также известен как mew). Это более понятное название свойства, которое контролирует толщину колпачка полосы погрешности в пунктах. Для совместимости со старыми версиями, если mew или markeredgewidth заданы, они будут переопределять capthick. В будущих версиях это может измениться. barsabovebool, optional, default: False Если True, полосы погрешностей будут отображаться над символами графика. По умолчанию - под символами. lolims, uplims, xlolims, xuplimsbool, optional, default: False Эти аргументы могут быть использованы для указания того, что значение дает только верхние/нижние пределы. В этом случае используется символ каретки для указания этого. Аргументы lims могут быть того же типа, что и xerr и yerr. Для использования пределов с инвертированными осями необходимо вызвать set_xlim() или set_ylim() перед errorbar(). erroreveryint or (int, int), optional, 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.

Возвращает:

containerErrorbarContainer Контейнер содержит: 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 для свойств маркера: Свойство Описание agg_filter функция фильтра, которая принимает (m, n, 3) массив чисел с плавающей точкой и значение dpi и возвращает (m, n, 3) массив alpha число с плавающей точкой или 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) массив или два 1D массива 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 стиль маркера markeredgecolor или mec цвет markeredgewidth или mew число с плавающей точкой markerfacecolor или mfc цвет markerfacecoloralt или mfcalt цвет markersize или ms число с плавающей точкой markevery None или целое число или (целое число, целое число) или срез или список целых чисел или число с плавающей точкой или (число с плавающей точкой, число с плавающей точкой) path_effects AbstractPathEffect picker число с плавающей точкой или вызываемый объект[[Художник, Событие], Кортеж[bool, словарь]] pickradius число с плавающей точкой rasterized bool или None sketch_params (масштаб: число с плавающей точкой, длина: число с плавающей точкой, случайность: число с плавающей точкой) snap bool или None solid_capstyle {'butt', 'round', 'projecting'} solid_joinstyle {'miter', 'round', 'bevel'} transform matplotlib.transforms.Transform url строка visible bool xdata 1D массив ydata 1D массив zorder число с плавающей точкой

Примечания

Примечание

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

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

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

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

Выбор предела ошибки