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)[исходный код]

Строит график зависимости y от x в виде линий и/или маркеров с соответствующими полосами погрешностей.

x, y задают положения данных, а xerr, yerr — размеры полос погрешностей. По умолчанию также отображаются маркеры/линии данных. Используйте fmt='none', чтобы нарисовать полосы погрешностей без маркеров данных.

Добавлено в версии 3.7: На полярных графиках ограничители и линии погрешностей рисуются в полярных координатах.

Параметры:

x, yчисло с плавающей точкой или массивоподобный объект

Положения данных.

xerr, yerrчисло с плавающей точкой или массивоподобный объект, формы (N,) или (2, N), необязательно

Размеры полос погрешностей:

скаляр: симметричные значения +/- для всех точек данных.
форма (N,): симметричные значения +/- для каждой точки данных.
форма (2, N): отдельные значения - и + для каждой полосы. Первая строка содержит нижние погрешности, вторая — верхние.
None: без полос погрешностей.

Все значения должны быть >= 0.

Пример использования xerr и yerr см. в разделе Различные способы задания полос погрешностей.

fmtstr, по умолчанию: ''

Формат точек данных / линий данных. Подробности см. в разделе plot.

Используйте 'none' (без учёта регистра), чтобы построить полосы погрешностей без маркеров данных.

ecolorцвет, по умолчанию: None

Цвет линий погрешностей. Если задано None, используется цвет линии, соединяющей маркеры.

elinewidthчисло с плавающей точкой, по умолчанию: None

Толщина линий погрешностей. Если задано None, используется толщина линии текущего стиля.

capsizeчисло с плавающей точкой, по умолчанию: rcParams["errorbar.capsize"] (по умолчанию: 0.0)

Длина ограничителей полос погрешностей в пунктах.

capthickчисло с плавающей точкой, по умолчанию: None

Псевдоним для аргумента ключевого слова markeredgewidth (также известного как mew). Это более понятное имя свойства, управляющего толщиной ограничителя полосы погрешности в пунктах. Для обратной совместимости, если задан mew или markeredgewidth, они имеют приоритет над capthick. В будущих выпусках это может измениться.

barsabovebool, по умолчанию: False

Если True, полосы погрешностей будут нарисованы поверх символов графика. По умолчанию они располагаются под ними.

lolims, uplims, xlolims, xuplimsbool или массивоподобный объект, по умолчанию: False

Эти аргументы позволяют указать, что значение задаёт только верхнюю/нижнюю границу. В этом случае для обозначения границы используется символ в виде стрелки. Аргументы lims могут быть скалярами или массивоподобными объектами той же длины, что и xerr и yerr. Для использования границ с инвертированными осями необходимо вызвать set_xlim или set_ylim до вызова errorbar(). Обратите внимание на непривычные имена параметров: например, значение True для lolims означает, что значение y является нижней границей истинного значения, поэтому будет нарисована только стрелка, направленная вверх!

erroreveryint или (int, int), по умолчанию: 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.

Возвращает:

ErrorbarContainer

Контейнер содержит:

data_line : экземпляр Line2D с маркерами и/или линией графика x, y.
caplines : кортеж экземпляров Line2D, представляющих ограничители полос погрешностей.
barlinecols : кортеж объектов LineCollection с горизонтальными и вертикальными интервалами погрешностей.

Другие параметры:

dataиндексируемый объект, необязательно

Если задано, следующие параметры также принимают строку s, которая интерпретируется как data[s], если s является ключом в data:

x, y, xerr, yerr

**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.

Допустимые аргументы ключевых слов для свойств маркера:

dashes
dash_capstyle
dash_joinstyle
drawstyle
fillstyle
linestyle
marker
markeredgecolor
markeredgewidth
markerfacecolor
markerfacecoloralt
markersize
markevery
solid_capstyle
solid_joinstyle

Дополнительные сведения см. в описании соответствующего свойства Line2D:

Свойство	Описание
`agg_filter`	функция фильтрации, принимающая массив чисел с плавающей точкой формы (m, n, 3) и значение dpi, а возвращающая массив формы (m, n, 3) и два смещения от левого нижнего угла изображения
`alpha`	число с плавающей точкой или None
`animated`	bool
`antialiased` или `aa`	bool
`clip_box`	`BboxBase` или None
`clip_on`	bool
`clip_path`	Patch или (Path, Transform) или None
`color` или `c`	цвет
`dash_capstyle`	`CapStyle` или {'butt', 'projecting', 'round'}
`dash_joinstyle`	`JoinStyle` или {'miter', 'round', 'bevel'}
`dashes`	последовательность чисел с плавающей точкой (чередование печати/пропуска в пунктах) или (None, None)
`data`	массив (2, N) или два одномерных массива
`drawstyle` или `ds`	{'default', 'steps', 'steps-pre', 'steps-mid', 'steps-post'}, по умолчанию: 'default'
`figure`	`Figure` или `SubFigure`
`fillstyle`	{'full', 'left', 'right', 'bottom', 'top', 'none'}
`gapcolor`	цвет или None
`gid`	str
`in_layout`	bool
`label`	объект
`linestyle` или `ls`	{'-', '--', '-.', ':', '', (offset, on-off-seq), ...}
`linewidth` или `lw`	число с плавающей точкой
`marker`	строка со стилем маркера, `Path` или `MarkerStyle`
`markeredgecolor` или `mec`	цвет
`markeredgewidth` или `mew`	число с плавающей точкой
`markerfacecolor` или `mfc`	цвет
`markerfacecoloralt` или `mfcalt`	цвет
`markersize` или `ms`	число с плавающей точкой
`markevery`	None, int, (int, int), slice, list[int], число с плавающей точкой, (число с плавающей точкой, число с плавающей точкой) или list[bool]
`mouseover`	bool
`path_effects`	список объектов `AbstractPathEffect`
`picker`	число с плавающей точкой или callable[[Artist, Event], tuple[bool, dict]]
`pickradius`	число с плавающей точкой
`rasterized`	bool
`sketch_params`	(scale: число с плавающей точкой, length: число с плавающей точкой, randomness: число с плавающей точкой)
`snap`	bool или None
`solid_capstyle`	`CapStyle` или {'butt', 'projecting', 'round'}
`solid_joinstyle`	`JoinStyle` или {'miter', 'round', 'bevel'}
`transform`	неизвестно
`url`	str
`visible`	bool
`xdata`	одномерный массив
`ydata`	одномерный массив
`zorder`	число с плавающей точкой

Примечания

Примечание

Это обёртка pyplot для axes.Axes.errorbar.

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

Выбор границ полос погрешностей

Отображение полос погрешностей на полярной оси

Функция errorbar

Различные способы задания полос погрешностей

Добавление верхних и нижних границ к полосам погрешностей

Создание прямоугольников из полос погрешностей с помощью PatchCollection

matplotlib.pyplot.errorbar

Примечания

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

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