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, axlim_clip=False, *, data=None, **kwargs)[исходный код]
-
Строит линии и/или маркеры с полосами погрешностей.
x/y/z задают положения данных, а xerr/yerr/zerr — размеры полос погрешностей. По умолчанию также отображаются маркеры/линии данных и полосы погрешностей. Используйте fmt='none', чтобы отобразить только полосы погрешностей.
- Параметры:
-
- x, y, zвещественное число или объект, подобный массиву
-
Положения данных.
- xerr, yerr, zerrвещественное число или объект, подобный массиву, формы (N,) или (2, N), необязательно
-
Размеры полос погрешностей:
- скаляр: симметричные значения +/- для всех точек данных.
- shape(N,): симметричные значения +/- для каждой точки данных.
- shape(2, N): отдельные значения - и + для каждой полосы. Первая строка содержит нижние погрешности, вторая строка — верхние.
- None: без полос погрешностей.
Обратите внимание, что все массивы погрешностей должны содержать положительные значения.
- fmtстрока, по умолчанию: ''
-
Формат точек данных / линий данных. Подробнее см.
plot.Используйте 'none' (без учета регистра), чтобы построить полосы погрешностей без маркеров данных.
- ecolorцвет, по умолчанию: None
-
Цвет линий погрешностей. Если задано None, используется цвет линии, соединяющей маркеры.
- elinewidthвещественное число, по умолчанию: None
-
Толщина линий погрешностей. Если задано None, используется толщина линии текущего стиля.
-
capsizeвещественное число, по умолчанию:
rcParams["errorbar.capsize"](по умолчанию:0.0) -
Длина ограничителей полос погрешностей в пунктах.
- capthickвещественное число, по умолчанию: None
-
Псевдоним ключевого аргумента markeredgewidth (также известного как mew). Это более понятное название свойства, управляющего толщиной ограничителя полосы погрешностей в пунктах. Для обратной совместимости, если заданы mew или markeredgewidth, они переопределяют capthick. В будущих версиях это может измениться.
- barsaboveлогическое значение, по умолчанию: False
-
Если True, полосы погрешностей отображаются поверх символов графика. По умолчанию они располагаются под ними.
- xlolims, ylolims, zlolimsлогическое значение, по умолчанию: False
-
Эти аргументы позволяют указать, что значение задает только нижние границы. В этом случае для их обозначения используется символ в виде шеврона. Аргументы lims могут быть скалярами или объектами, подобными массивам, той же длины, что и погрешности. Чтобы использовать границы с инвертированными осями, перед вызовом
errorbarнеобходимо вызватьset_xlim,set_ylimилиset_zlim. Обратите внимание на непривычные имена параметров: например, установка ylolims в True означает, что значение y является нижней границей истинного значения, поэтому будет нарисована только стрелка, направленная вверх! - xuplims, yuplims, zuplimsлогическое значение, по умолчанию: False
-
То же, что выше, но для управления верхними границами.
- erroreveryцелое число или (целое число, целое число), по умолчанию: 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.
- axlim_clipлогическое значение, по умолчанию: False
-
Следует ли скрывать полосы погрешностей, находящиеся за пределами осей.
Добавлено в версии 3.10.
- Возвращает:
-
- errlinesсписок
-
Список экземпляров
Line3DCollection, каждый из которых содержит линию полосы погрешности. - caplinesсписок
-
Список экземпляров
Line3D, каждый из которых содержит объект линии ограничителя. - limmarksсписок
-
Список экземпляров
Line3D, каждый из которых содержит маркер с верхней или нижней границей.
- Другие параметры:
-
- dataиндексируемый объект, необязательно
-
Если задан, следующие параметры также принимают строку
s, которая интерпретируется какdata[s], еслиsявляется ключом вdata:x, y, z, xerr, yerr, zerr
- **kwargs
-
Все остальные ключевые аргументы для настройки линий погрешностей передаются в
Line3DCollection.
Примеры
(
Source code,2x.png,png)
Примеры использования mpl_toolkits.mplot3d.axes3d.Axes3D.errorbar
© 2012–2026 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