Spec-Zone.ru › Matplotlib

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

Полосы погрешностей в 3D

Полосы погрешностей в 3D

© 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API