matplotlib.pyplot.errorbar#

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

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

x, y definieren die Datenpositionen, xerr, yerr definieren die Größen der Fehlerbalken. Standardmäßig werden die Datenmarkierungen/-linien sowie die Fehlerbalken gezeichnet. Verwenden Sie fmt='none', um Fehlerbalken ohne Datenmarkierungen zu zeichnen.

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

Parameter:

x, yfloat oder array-ähnlich

Die Datenpositionen.

xerr, yerrfloat oder array-ähnlich, Form(N,) oder Form(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 anzugeben, dass ein Wert nur obere/untere Grenzen darstellt. In diesem Fall wird ein Caret-Symbol verwendet, um dies anzuzeigen. lims-Argumente können Skalare oder array-ähnliche Werte mit derselben 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 Sie z. B. lolims auf True setzen, bedeutet dies, dass der y-Wert eine untere Grenze des tatsächlichen Werts ist, sodass nur ein nach oben gerichteter Pfeil gezeichnet wird!

erroreveryint oder (int, int), Standard: 1

zeichnet Fehlerbalken für eine Teilmenge der Daten. errorevery =N zeichnet Fehlerbalken für die Punkte (x[::N], y[::N]). errorevery =(start, N) zeichnet Fehlerbalken für die Punkte (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 gemeinsame x-Achsenwerte haben.

Gibt zurück:

ErrorbarContainer

Der Container enthält

data_line : Eine Line2D-Instanz von x, y Plot-Markierungen und/oder Linien.
caplines : Ein Tupel von Line2D-Instanzen der Fehlerbalken-Kappen.
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 Markierungen zeichnet. Zum Beispiel macht dieser Code 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üsselwortargumente für die Markierungseigenschaften 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