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', чтобы отобразить только области с ошибками.

Параметры:

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.

Возвращает:

errlinesсписок

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

caplinesсписок

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

limmarksсписок

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

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

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

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

x, y, z, xerr, yerr, zerr

**kwargs

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

Примеры

(Source code, 2x.png, png)