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, hold=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 (a.k.a. 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, линии погрешности будут нарисованы для каждой 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 число с плавающей точкой (от 0.0 — прозрачный до 1.0 — непрозрачный) animated логическое значение antialiased или aa логическое значение clip_box экземпляр Bbox clip_on логическое значение clip_path [(Path, Transform) | Patch | None] color или c любой цвет matplotlib contains вызываемая функция dash_capstyle ['butt' | 'round' | 'projecting'] dash_joinstyle ['miter' | 'round' | 'bevel'] dashes последовательность включения/выключения чернил в точках drawstyle ['default' | 'steps' | 'steps-pre' | 'steps-mid' | 'steps-post'] figure экземпляр Figure fillstyle ['full' | 'left' | 'right' | 'bottom' | 'top' | 'none'] gid строка идентификатора label объект linestyle или ls ['solid' | 'dashed', 'dashdot', 'dotted' | (смещение, последовательность вкл/выкл) | '-' | '--' | '-.' | ':' | 'None' | ' ' | ''] linewidth или lw величина значения в точках marker A valid marker style markeredgecolor или mec любой цвет matplotlib markeredgewidth или mew величина значения в точках markerfacecolor или mfc любой цвет matplotlib markerfacecoloralt или mfcalt любой цвет matplotlib markersize или ms число с плавающей точкой markevery [None | целое число | пара из двух целых чисел | срез | список/массив целых чисел | число с плавающей точкой | пара из двух чисел с плавающей точкой] path_effects AbstractPathEffect picker расстояние в точках или вызываемая функция для выбора fn(artist, event) pickradius расстояние в точках rasterized логическое значение или None sketch_params (масштаб: число с плавающей точкой, длина: число с плавающей точкой, случайность: число с плавающей точкой) snap логическое значение или None solid_capstyle ['butt' | 'round' | 'projecting'] solid_joinstyle ['miter' | 'round' | 'bevel'] transform экземпляр matplotlib.transforms.Transform url строка url visible логическое значение xdata одномерный массив ydata одномерный массив zorder число с плавающей точкой

Примечания

Примечание

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

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

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

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