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_ylimoderset_zlimvorerrorbaraufgerufen 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 alsdata[s]interpretiert wird, wennsein Schlüssel indataistx, y, z, xerr, yerr, zerr
- **kwargs
Alle anderen Schlüsselwortargumente für die Formatierung von Fehlerbalkenlinien werden an
Line3DCollectionübergeben.
Beispiele