mpl_toolkits.mplot3d.axes3d.Axes3D.errorbar

Axes3D.errorbar(x, y, z, zerr=None, yerr=None, xerr=None, fmt='', barsabove=False, errorevery=1, ecolor=None, elinewidth=None, capsize=None, capthick=None, xlolims=False, xuplims=False, ylolims=False, yuplims=False, zlolims=False, zuplims=False, *, data=None, **kwargs)[source]

Отрисовка линий и/или маркеров с областями погрешностей вокруг них.

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

Parameters:

x, y, zfloat или array-like

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

xerr, yerr, zerrfloat или array-like, форма (N,) или (2, N), необязательно

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

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

Обратите внимание, что все массивы погрешностей должны иметь положительные значения.

fmtстрока, по умолчанию: ''

Формат точек данных / линий данных. См. plot для получения подробной информации.

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

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

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

elinewidthfloat, по умолчанию: None

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

capsizefloat, по умолчанию: rcParams["errorbar.capsize"] (по умолчанию: 0.0)

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

capthickfloat, по умолчанию: None

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

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

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

xlolims, ylolims, zlolimsbool, по умолчанию: False

Эти аргументы могут использоваться для указания того, что значение дает только нижние границы. В этом случае используется символ каретки для обозначения этого. Аргументы lims могут быть скалярами или массивоподобными величинами такой же длины, что и погрешности. Для использования границ с инвертированными осями необходимо вызвать set_xlim или set_ylim перед errorbar. Обратите внимание на хитроумные имена параметров: установка, например, ylolims в True означает, что значение y является нижней границей истинного значения, поэтому будет нарисована только стрелка, направленная вверх!

xuplims, yuplims, zuplimsbool, по умолчанию: False

То же самое, что и выше, но для управления верхними границами.

erroreveryint или (int, int), по умолчанию: 1

рисует области погрешностей на подмножестве данных. errorevery =N рисует области погрешностей для точек (x[::N], y[::N], z[::N]). errorevery =(start, N) рисует области погрешностей для точек (x[start::N], y[start::N], z[start::N]). Например, errorevery=(6, 3) добавляет области погрешностей к данным в (x[6], x[9], x[12], x[15], ...). Используется для предотвращения перекрывания областей погрешностей, когда две серии данных используют общие значения x-оси.

Returns:

errlinesсписок

Список экземпляров Line3DCollection, каждый из которых содержит линию области погрешности.

caplinesсписок

Список экземпляров Line3D, каждый из которых содержит объект колпачка.

limmarksсписок

Список экземпляров Line3D, каждый из которых содержит маркер с верхней или нижней границей.

Other Parameters:

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

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

x, y, z, xerr, yerr, zerr

**kwargs

Все остальные ключевые аргументы для стилизации линий областей погрешностей передаются Line3DCollection.

Примеры

(Source code, png)