matplotlib.axes.Axes.errorbar#

Axes.errorbar(x, y, yerr=None, xerr=None, fmt='', *, ecolor=None, elinewidth=None, capsize=None, barsabove=False, lolims=False, uplims=False, xlolims=False, xuplims=False, errorevery=1, capthick=None, data=None, **kwargs)[Quelle]#

Plottet y gegen x als Linien und/oder Markierungen mit angehängten Fehlerbalken.

x, y definieren die Datenpositionen, xerr, yerr definieren die Fehlerbalkengrößen. Standardmäßig werden die Datenmarker/Linien sowie die Fehlerbalken gezeichnet. Verwenden Sie fmt='none', um Fehlerbalken ohne Datenmarker zu zeichnen.

Hinzugefügt in Version 3.7: Kappen und Fehlerlinien werden in Polarkoordinaten auf Polarplots gezeichnet.

Parameter:

x, yfloat oder array-ähnlich

Die Datenpositionen.

xerr, yerrfloat oder array-ähnlich, shape(N,) oder shape(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.

Alle Werte müssen >= 0 sein.

Siehe Verschiedene Möglichkeiten zur Angabe von Fehlerbalken für ein Beispiel zur Verwendung von xerr und yerr.

fmtstr, Standard: ''

Das Format für die Datenpunkte / Datenlinien. Siehe plot für Details.

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.

lolims, uplims, xlolims, xuplimsbool oder array-ähnlich, Standard: False

Diese Argumente können verwendet werden, um anzuzeigen, dass ein Wert nur obere/untere Grenzen angibt. In diesem Fall wird ein Caret-Symbol verwendet, um dies anzuzeigen. lims-Argumente können Skalare oder array-ähnliche Werte der gleichen Länge wie xerr und yerr sein. Um Grenzen mit invertierten Achsen zu verwenden, muss set_xlim oder set_ylim vor errorbar() aufgerufen werden. Beachten Sie die kniffligen Parameternamen: Wenn z. B. lolims auf True gesetzt wird, bedeutet dies, dass der y-Wert eine untere Grenze des wahren Wertes ist, sodass nur ein nach oben gerichteter Pfeil gezeichnet wird!

erroreveryint oder (int, int), Standard: 1

Zeichnet Fehlerbalken auf einer Teilmenge der Daten. errorevery =N zeichnet Fehlerbalken auf den Punkten (x[::N], y[::N]). errorevery =(start, N) zeichnet Fehlerbalken auf den Punkten (x[start::N], y[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 die gleichen x-Achsenwerte haben.

Gibt zurück:

ErrorbarContainer

Der Container enthält

data_line : Eine Line2D-Instanz von x, y-Plot-Markern und/oder Linie.
caplines : Ein Tupel von Line2D-Instanzen der Fehlerbalkenkappen.
barlinecols : Ein Tupel von LineCollection mit den horizontalen und vertikalen Fehlerbereichen.

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, xerr, yerr

**kwargs

Alle anderen Schlüsselwortargumente werden an den plot-Aufruf weitergegeben, der die Marker zeichnet. Dieser Code erstellt beispielsweise große rote Quadrate mit dicken grünen Rändern

x, y, yerr = rand(3, 10)
errorbar(x, y, yerr, marker='s', mfc='red',
         mec='green', ms=20, mew=4)

wobei mfc, mec, ms und mew Aliase für die längeren Eigenschaftsnamen markerfacecolor, markeredgecolor, markersize und markeredgewidth sind.

Gültige Schlüsselwörter für die Markereigenschaften sind

dashes
dash_capstyle
dash_joinstyle
drawstyle
fillstyle
Linienstil (linestyle)
marker
markeredgecolor
markeredgewidth
markerfacecolor
markerfacecoloralt
markersize
markevery
solid_capstyle
solid_joinstyle

Siehe die entsprechende Line2D-Eigenschaft für weitere Details

Eigenschaft	Beschreibung
`agg_filter`	eine Filterfunktion, die ein (m, n, 3) Float-Array und einen dpi-Wert entgegennimmt und ein (m, n, 3) Array und zwei Offsets von der linken unteren Ecke des Bildes zurückgibt
`alpha`	float oder None
`animated`	bool
`antialiased` oder `aa`	bool
`clip_box`	`BboxBase` oder None
`clip_on`	bool
`clip_path`	Patch oder (Path, Transform) oder None
`color` oder `c`	color
`dash_capstyle`	`CapStyle` oder {'butt', 'projecting', 'round'}
`dash_joinstyle`	`JoinStyle` oder {'miter', 'round', 'bevel'}
`dashes`	Sequenz von Floats (An/Aus-Linie in Punkten) oder (None, None)
`Daten`	(2, N) Array oder zwei 1D-Arrays
`drawstyle` oder `ds`	{'default', 'steps', 'steps-pre', 'steps-mid', 'steps-post'}, Standard: 'default'
`figure`	`Figure` oder `SubFigure`
`fillstyle`	{'full', 'left', 'right', 'bottom', 'top', 'none'}
`gapcolor`	Farbe oder None
`gid`	str
`in_layout`	bool
`label`	object
`linestyle` oder `ls`	{'-', '--', '-.', ':', '', (offset, on-off-seq), ...}
`linewidth` oder `lw`	float
`marker`	Marker-Stil-String, `Path` oder `MarkerStyle`
`markeredgecolor` oder `mec`	color
`markeredgewidth` oder `mew`	float
`markerfacecolor` oder `mfc`	color
`markerfacecoloralt` oder `mfcalt`	color
`markersize` oder `ms`	float
`markevery`	None oder int oder (int, int) oder Slice oder list[int] oder float oder (float, float) oder list[bool]
`mouseover`	bool
`path_effects`	Liste von `AbstractPathEffect`
`picker`	float oder aufrufbar[[Artist, Event], tuple[bool, dict]]
`pickradius`	float
`rasterized`	bool
`sketch_params`	(scale: float, length: float, randomness: float)
`snap`	bool oder None
`solid_capstyle`	`CapStyle` oder {'butt', 'projecting', 'round'}
`solid_joinstyle`	`JoinStyle` oder {'miter', 'round', 'bevel'}
`transform`	unknown
`url`	str
`visible`	bool
`xdata`	1D-Array
`ydata`	1D-Array
`zorder`	float