matplotlib.axes.Axes.errorbar

Axes.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: 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 | целое число | кортеж длины 2 из целых чисел | срез | список/массив целых чисел | вещественное число | кортеж длины 2 из вещественных чисел] 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'.