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 ) [Quelle] #
Zeichnen Sie y gegen x als Linien und/oder Markierungen mit angehängten Fehlerbalken.
x , y definieren die Datenspeicherorte, xerr , yerr definieren die Fehlerbalkengrößen. Standardmäßig zeichnet dies die Datenmarker/-linien sowie die Fehlerbalken. Verwenden Sie fmt='none', um Fehlerbalken ohne Datenmarkierungen zu zeichnen.
- Parameter :
- x, y Float oder Array-artig
Die Datenpositionen.
- xerr, yerr float oder arrayartig, shape(N,) oder shape(2, N), optional
Die Fehlerbalkengrößen:
Skalar: Symmetrische +/- Werte für alle Datenpunkte.
shape(N,): Symmetrische +/-Werte für jeden Datenpunkt.
shape(2, N): Separate - und + Werte für jeden Balken. Die erste Reihe enthält die unteren Fehler, die zweite Reihe die oberen Fehler.
None : Keine Fehlerleiste.
Alle Werte müssen >= 0 sein.
Ein Beispiel für die Verwendung von und finden Sie unter Verschiedene Möglichkeiten zum Angeben von Fehlerbalken .
xerr
yerr
- fmt str, Standard: ''
Das Format für die Datenpunkte / Datenzeilen. Siehe
plot
für Details.Verwenden Sie „none“ (Groß-/Kleinschreibung wird nicht beachtet), um Fehlerbalken ohne Datenmarkierungen zu zeichnen.
- ecolor -Farbe, Standard: Keine
Die Farbe der Fehlerbalkenlinien. Wenn keine, verwenden Sie die Farbe der Linie, die die Markierungen verbindet.
- elinewidth float, Standard: Keine
Die Linienbreite der Fehlerbalkenlinien. Wenn None, wird die Linienbreite des aktuellen Stils verwendet.
- Float kentern , Standard: (Standard: )
rcParams["errorbar.capsize"]
0.0
Die Länge des Fehlerbalkens wird in Punkten begrenzt.
- capthick Float, Standard: Keine
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. Wenn mew oder markeredgewidth angegeben sind, überschreiben sie aus Gründen der Abwärtskompatibilität capthick . Dies kann sich in zukünftigen Versionen ändern.
- Barsabove bool, Standard: False
Wenn True, werden die Fehlerbalken über den Diagrammsymbolen gezeichnet. Standard ist unten.
- lolims, uplims, xlolims, xuplims bool, Standard: False
Diese Argumente können verwendet werden, um anzuzeigen, dass ein Wert nur Ober-/Untergrenzen angibt. In diesem Fall wird ein Caret-Symbol verwendet, um dies anzuzeigen. lims -Argumente können Skalare oder Arrays mit der gleichen Länge wie xerr und yerr sein . Um Limits mit invertierten Achsen zu verwenden, muss
set_xlim
oder vorher aufgerufen werden . Beachten Sie die kniffligen Parameternamen: Das Setzen von zB lolims auf True bedeutet, dass der y-Wert eine untere Grenze des True-Werts ist, also wird nur ein nach oben zeigender Pfeil gezeichnet!set_ylim
errorbar()
- errorevery int oder (int, int), Standard: 1
zeichnet Fehlerbalken auf einer Teilmenge der Daten. errorevery =N zeichnet Fehlerbalken auf die Punkte (x[::N], y[::N]). errorevery =(start, N) zeichnet Fehlerbalken an den Punkten (x[start::N], y[start::N]). zB 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.
- Rückgaben :
ErrorbarContainer
Der Behälter enthält:
plotline:
Line2D
Instanz von x-, y-Plotmarkierungen und/oder Linien.caplines: Ein Tupel von
Line2D
Instanzen der Fehlerbalken-Caps.barlinecols: Ein Tupel von
LineCollection
mit den horizontalen und vertikalen Fehlerbereichen.
- Andere Parameter :
- data indexierbares Objekt, optional
Falls angegeben, akzeptieren die folgenden Parameter auch einen String
s
, der interpretiert wird alsdata[s]
(es sei denn, dies löst eine Ausnahme aus):x , y , xerr , yerr
- **Kwarg
Alle anderen Schlüsselwortargumente werden an den
plot
Aufruf übergeben, der die Markierungen zeichnet. Dieser Code macht zum Beispiel 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 kwargs für die Markereigenschaften sind:
Striche
dash_capstyle
dash_joinstyle
Zeichenstil
Füllstil
Linienstil
Marker
Markierungsrandfarbe
Markierungsbreite
Markierungsfarbe
MarkerGesichtFarbeAlt
Markergröße
Markevery
solid_capstyle
solid_joinstyle
Weitere Informationen finden Sie bei der entsprechenden
Line2D
Immobilie:Eigentum
Beschreibung
eine Filterfunktion, die ein (m, n, 3) Float-Array und einen dpi-Wert akzeptiert und ein (m, n, 3)-Array und zwei Offsets von der unteren linken Ecke des Bildes zurückgibt
Skalar oder Keine
bool
antialiased
oder ähbool
bool
Patch oder (Pfad, Transform) oder None
color
oder cFarbe
CapStyle
oder {'hinter', 'vorstehend', 'rund'}JoinStyle
oder {'Gehrung', 'rund', 'Fase'}Folge von Gleitkommazahlen (Ein/Aus Tinte in Punkten) oder (Keine, Keine)
(2, N)-Array oder zwei 1D-Arrays
drawstyle
oder DS{'default', 'steps', 'steps-pre', 'steps-mid', 'steps-post'}, default: 'default'
{'voll', 'links', 'rechts', 'unten', 'oben', 'keine'}
Farbe oder Keine
Str
bool
Objekt
linestyle
oder ls{'-', '--', '-.', ':', '', (offset, on-off-seq), ...}
linewidth
oder lwschweben
Marker-Style-String
Path
oderMarkerStyle
markeredgecolor
oder mecFarbe
markeredgewidth
oder miauschweben
markerfacecolor
oder mfcFarbe
markerfacecoloralt
oder mfcaltFarbe
markersize
oder msschweben
None oder int oder (int, int) oder slice oder list[int] oder float oder (float, float) oder list[bool]
bool
float or callable[[Artist, Event], tuple[bool, dict]]
Unbekannt
bool
(Maßstab: Float, Länge: Float, Zufälligkeit: Float)
bool oder Keine
CapStyle
oder {'hinter', 'vorstehend', 'rund'}JoinStyle
oder {'Gehrung', 'rund', 'Fase'}Unbekannt
Str
bool
1D-Array
1D-Array
schweben
Beispiele mit matplotlib.pyplot.errorbar
#
Auswahl der Fehlerbalkengrenze