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)[source]#

Zeichnet Linien und/oder Marker mit Fehlerbalken.

x/y/z definieren die Datenpositionen und xerr/yerr/zerr definieren die Größen der Fehlerbalken. Standardmäßig werden die Datenmarker/Linien sowie die Fehlerbalken gezeichnet. Verwenden Sie fmt='none', um nur Fehlerbalken zu zeichnen.

Parameter:
x, y, zfloat oder array-ähnlich

Die Datenpositionen.

xerr, yerr, zerrfloat oder array-ähnlich, Form (N,) oder (2, N), optional

Die Fehlerbalkengrößen

  • Skalar: Symmetrische +/- Werte für alle Datenpunkte.

  • Form(N,): Symmetrische +/- Werte für jeden Datenpunkt.

  • Form(2, N): Separate - und + Werte für jeden Balken. Die erste Zeile enthält die unteren Fehler, die zweite Zeile die oberen Fehler.

  • None: Kein Fehlerbalken.

Beachten Sie, dass alle Fehler-Arrays *positive* Werte haben sollten.

fmtstr, Standard: ''

Das Format für die Datenpunkte / Datenlinien. Details finden Sie unter plot.

Verwenden Sie 'none' (Groß-/Kleinschreibung wird nicht beachtet), um Fehlerbalken ohne Datenmarker zu zeichnen.

ecolorFarbe, Standard: None

Die Farbe der Fehlerbalkenlinien. Wenn None, wird die Farbe der Linie verwendet, die die Marker verbindet.

elinewidthfloat, Standard: None

Die Linienbreite der Fehlerbalkenlinien. Wenn None, wird die Linienbreite des aktuellen Stils verwendet.

capsizefloat, Standard: rcParams["errorbar.capsize"] (Standard: 0.0)

Die Länge der Fehlerbalkenkappen in Punkten.

capthickfloat, Standard: None

Ein Alias für das Schlüsselwortargument markeredgewidth (auch bekannt als mew). Diese Einstellung ist ein sinnvollerer Name für die Eigenschaft, die die Dicke der Fehlerbalkenkappe in Punkten steuert. Aus Kompatibilitätsgründen werden, wenn mew oder markeredgewidth angegeben sind, diese capthick überschreiben. Dies kann sich in zukünftigen Versionen ändern.

barsabovebool, Standard: False

Wenn True, werden die Fehlerbalken über den Plot-Symbolen gezeichnet. Standard ist darunter.

xlolims, ylolims, zlolimsbool, Standard: False

Diese Argumente können verwendet werden, um anzuzeigen, dass ein Wert nur untere Grenzwerte angibt. In diesem Fall wird ein Pfeilsymbol verwendet, um dies anzuzeigen. lims-Argumente können Skalare oder array-ähnliche Werte mit der gleichen Länge wie die Fehler sein. Um Grenzwerte mit invertierten Achsen zu verwenden, müssen set_xlim, set_ylim oder set_zlim vor errorbar aufgerufen werden. Beachten Sie die kniffligen Parameternamen: Wenn Sie z.B. ylolims auf True setzen, bedeutet dies, dass der y-Wert ein *unterer* Grenzwert des wahren Wertes ist, sodass nur ein nach *oben* zeigender Pfeil gezeichnet wird!

xuplims, yuplims, zuplimsbool, Standard: False

Dasselbe wie oben, aber zur Steuerung der oberen Grenzwerte.

erroreveryint oder (int, int), Standard: 1

zeichnet Fehlerbalken für einen Teil der Daten. errorevery =N zeichnet Fehlerbalken für die Punkte (x[::N], y[::N], z[::N]). errorevery =(start, N) zeichnet Fehlerbalken für die Punkte (x[start::N], y[start::N], z[start::N]). z.B. errorevery =(6, 3) fügt Fehlerbalken zu den Daten bei (x[6], x[9], x[12], x[15], ...) hinzu. Wird verwendet, um überlappende Fehlerbalken zu vermeiden, wenn zwei Reihen gemeinsame x-Achsenwerte haben.

axlim_clipbool, Standard: False

Ob Fehlerbalken, die außerhalb der Achsenbegrenzungen liegen, ausgeblendet werden sollen.

Hinzugefügt in Version 3.10.

Gibt zurück:
errlineslist

Liste von Line3DCollection-Instanzen, die jeweils eine Fehlerbalkenlinie enthalten.

caplineslist

Liste von Line3D-Instanzen, die jeweils ein Kappenlinienobjekt enthalten.

limmarkslist

Liste von Line3D-Instanzen, die jeweils einen Marker mit einem oberen oder unteren Grenzwert enthalten.

Andere Parameter:
dataindizierbares Objekt, optional

Wenn angegeben, akzeptieren die folgenden Parameter auch einen String s, der als data[s] interpretiert wird, wenn s ein Schlüssel in data ist

x, y, z, xerr, yerr, zerr

**kwargs

Alle anderen Schlüsselwortargumente für die Formatierung von Fehlerbalkenlinien werden an Line3DCollection übergeben.

Beispiele

(Quellcode, 2x.png, png)

Beispiele für die Verwendung von mpl_toolkits.mplot3d.axes3d.Axes3D.errorbar#

3D-Fehlerbalken

3D-Fehlerbalken