matplotlib.pyplot.bar #
- matplotlib.pyplot. bar ( x , height , width = 0.8 , bottom = None , * , align = 'center' , data = None , ** kwargs ) [source] #
Erstellen Sie ein Balkendiagramm.
Die Stäbe werden bei x mit der gegebenen Ausrichtung positioniert . Ihre Abmessungen sind durch Höhe und Breite gegeben . Die vertikale Grundlinie ist unten (Standard 0).
Viele Parameter können entweder einen einzelnen Wert annehmen, der für alle Balken gilt, oder eine Folge von Werten, einen für jeden Balken.
- Parameter :
- x Float oder Array-ähnlich
Die x-Koordinaten der Balken. Siehe auch ausrichten für die Ausrichtung der Balken an den Koordinaten.
- Höhe Float oder Array-artig
Die Höhe(n) der Balken.
- Breite Float oder Array-artig, Standard: 0,8
Die Breite(n) der Balken.
- Bottom Float oder Array-ähnlich, Standard: 0
Die y-Koordinate(n) der Unterseite(n) der Balken.
- ausrichten {'center', 'edge'}, default: 'center'
Ausrichtung der Balken zu den x -Koordinaten:
'center': Zentrieren Sie die Basis auf den x - Positionen.
'Kante': Richten Sie die linken Kanten der Balken an den x - Positionen aus.
Um die Balken am rechten Rand auszurichten, übergeben Sie eine negative Breite und
align='edge'
.
- Rückgaben :
BarContainer
Container mit allen Balken und optional Fehlerbalken.
- Andere Parameter :
- Farbe Farbe oder Farbliste, optional
Die Farben der Balkenflächen.
- edgecolor Farbe oder Farbliste, optional
Die Farben der Balkenkanten.
- Linienbreite Float oder Array-artig, optional
Breite der Stangenkante(n). Wenn 0, keine Kanten zeichnen.
- tick_label str oder Liste von str, optional
Die Tick-Labels der Bars. Standard: Keine (Numerische Standardbeschriftungen verwenden.)
- label str oder list of str, optional
An das Ergebnis wird ein einzelnes Label
BarContainer
als Label für den gesamten Datensatz angehängt. Falls eine Liste vorhanden ist, muss diese die gleiche Länge wie x haben und beschriftet die einzelnen Balken. Wiederholte Beschriftungen werden nicht dedupliziert und führen zu wiederholten Beschriftungseinträgen. Daher wird dies am besten verwendet, wenn sich die Balken auch im Stil unterscheiden (z. B. durch Übergabe einer Liste an color .)- xerr, yerr Float oder Array-ähnlich von shape(N,) oder shape(2, N), optional
Wenn nicht None , fügen Sie horizontale/vertikale Fehlerbalken zu den Balkenspitzen hinzu. Die Werte sind +/- Größen relativ zu den Daten:
Skalar: symmetrische +/- Werte für alle Bars
shape(N,): symmetrische +/- Werte für jeden Balken
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. (Standard)
Ein Beispiel für die Verwendung von xerr und yerr finden Sie unter Verschiedene Möglichkeiten, Fehlerbalken anzugeben .
- ecolor Farbe oder Farbliste, Standard: 'schwarz'
Die Linienfarbe der Fehlerbalken.
- Float kentern , Standard: (Standard: )
rcParams["errorbar.capsize"]
0.0
Die Länge des Fehlerbalkens wird in Punkten begrenzt.
- error_kw Diktat , optional
Wörterbuch der Schlüsselwortargumente, die an die
errorbar
Methode übergeben werden sollen. Die hier definierten Werte von ecolor oder capsize haben Vorrang vor den unabhängigen Schlüsselwortargumenten.- log bool, Standard: False
Wenn True , legen Sie die y-Achse als logarithmische Skalierung fest.
- data indexierbares Objekt, optional
Wenn angegeben, akzeptieren alle Parameter auch einen String
s
, der als interpretiert wirddata[s]
(es sei denn, dies löst eine Ausnahme aus).- **kwargs-
Rectangle
Eigenschaften 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
Unbekannt
bool
antialiased
oder ähbool oder Keine
(links, unten, Breite, Höhe)
CapStyle
oder {'hinter', 'vorstehend', 'rund'}bool
Patch oder (Pfad, Transform) oder None
Farbe
edgecolor
oder ecFarbe oder Keine
facecolor
oder FCFarbe oder Keine
bool
Str
{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
Unbekannt
bool
JoinStyle
oder {'Gehrung', 'rund', 'Fase'}Objekt
linestyle
oder ls{'-', '--', '-.', ':', '', (offset, on-off-seq), ...}
linewidth
oder lwFloat oder None
bool
None oder bool oder float oder aufrufbar
bool
(Maßstab: Float, Länge: Float, Zufälligkeit: Float)
bool oder Keine
Str
bool
Unbekannt
Unbekannt
(schweben, schweben)
Unbekannt
schweben
Siehe auch
barh
Zeichnen Sie ein horizontales Balkendiagramm.
Anmerkungen
Gestapelte Balken können erreicht werden, indem einzelne untere Werte pro Balken übergeben werden. Siehe Gestapeltes Balkendiagramm .