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илиset_zlimдолжны быть вызваны до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,2x.png,png)
Примеры использования mpl_toolkits.mplot3d.axes3d.Axes3D.errorbar
© 2012–2023 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/stable/api/_as_gen/mpl_toolkits.mplot3d.axes3d.Axes3D.errorbar.html