matplotlib.pyplot.bar#

matplotlib.pyplot.bar(x, height, width=0.8, bottom=None, *, align='center', data=None, **kwargs)[Quelle]#

Erzeugt ein Balkendiagramm.

Die Balken werden bei x mit der gegebenen alignment positioniert. Ihre Abmessungen werden durch height und width bestimmt. Die vertikale Grundlinie ist bottom (Standard 0).

Viele Parameter können entweder einen einzelnen Wert annehmen, der für alle Balken gilt, oder eine Sequenz von Werten, einen für jeden Balken.

Parameter:

xfloat oder array-ähnlich

Die x-Koordinaten der Balken. Siehe auch align für die Ausrichtung der Balken zu den Koordinaten.

Balken werden oft für kategoriale Daten verwendet, d.h. für Zeichenkettenbeschriftungen unter den Balken. Sie können eine Liste von Zeichenketten direkt an x übergeben. bar(['A', 'B', 'C'], [1, 2, 3]) ist oft eine kürzere und praktischere Notation im Vergleich zu bar(range(3), [1, 2, 3], tick_label=['A', 'B', 'C']). Sie sind äquivalent, solange die Namen eindeutig sind. Die explizite tick_label Notation zeichnet die Namen in der angegebenen Reihenfolge. Wenn jedoch doppelte Werte in den kategorialen x-Daten vorhanden sind, werden diese Werte derselben numerischen x-Koordinate zugeordnet, und die entsprechenden Balken werden übereinander gezeichnet.

heightfloat oder array-ähnlich

Die Höhe(n) der Balken.

Beachten Sie, dass wenn bottom Einheiten hat (z.B. Datum), height Einheiten haben sollte, die eine Differenz zum Wert von bottom sind (z.B. Zeitdifferenz).

widthfloat oder array-ähnlich, Standard: 0.8

Die Breite(n) der Balken.

Beachten Sie, dass wenn x Einheiten hat (z.B. Datum), width Einheiten haben sollte, die eine Differenz (z.B. Zeitdifferenz) um die x-Werte herum darstellen.

bottomfloat oder array-ähnlich, Standard: 0

Die y-Koordinate(n) der unteren Seite(n) der Balken.

Beachten Sie, dass wenn bottom Einheiten hat, die y-Achse einen Locator und Formatter erhält, der für die Einheiten geeignet ist (z.B. Daten oder kategorial).

align{'center', 'edge'}, Standard: 'center'

Ausrichtung der Balken zu den x-Koordinaten

'center': Zentriert die Basis auf den x-Positionen.
'edge': Richtet die linken Kanten der Balken an den x-Positionen aus.

Um die Balken am rechten Rand auszurichten, übergeben Sie eine negative width und align='edge'.

Gibt zurück:

BarContainer: Container mit allen Balken und optional Fehlerbalken.

Andere Parameter:

colorFarbe oder Liste von Farben, optional

Die Farben der Balkenflächen. Dies ist ein Alias für facecolor. Wenn beide angegeben sind, hat facecolor Vorrang.

facecolorFarbe oder Liste von Farben, optional

Die Farben der Balkenflächen. Wenn sowohl color als auch facecolor angegeben sind, hat facecolor Vorrang.

edgecolorFarbe oder Liste von Farben, optional

Die Farben der Balkenkanten.

linewidthfloat oder array-ähnlich, optional

Breite der Balkenkante(n). Wenn 0, werden keine Kanten gezeichnet.

tick_labelstr oder Liste von str, optional

Die Tick-Beschriftungen der Balken. Standard: None (Verwendet Standard-Numerische Beschriftungen.)

labelstr oder Liste von str, optional

Ein einzelnes Label wird an den resultierenden BarContainer als Label für den gesamten Datensatz angehängt. Wenn eine Liste angegeben wird, muss diese die gleiche Länge wie x haben und die einzelnen Balken beschriften. Wiederholte Labels werden nicht dedupliziert und führen zu wiederholten Label-Einträgen, daher ist dies am besten geeignet, wenn sich die Balken auch im Stil unterscheiden (z.B. durch Übergabe einer Liste an color).

xerr, yerrfloat oder array-ähnlich der Form(N,) oder Form(2, N), optional

Wenn nicht None, fügen Sie horizontale/vertikale Fehlerbalken an den Balkenspitzen hinzu. Die Werte sind +/- Größen relativ zu den Daten

Skalar: symmetrische +/- Werte für alle Balken
Form(N,): symmetrische +/- Werte für jeden Balken
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. (Standard)

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

ecolorFarbe oder Liste von Farben, Standard: 'black'

Die Linienfarbe der Fehlerbalken.

capsizefloat, Standard: rcParams["errorbar.capsize"] (Standard: 0.0)

Die Länge der Fehlerbalkenkappen in Punkten.

error_kwdict, optional

Wörterbuch von Schlüsselwortargumenten, die an die errorbar-Methode übergeben werden. Werte von ecolor oder capsize, die hier definiert sind, haben Vorrang vor den unabhängigen Schlüsselwortargumenten.

logbool, Standard: False

Wenn True, wird die y-Achse auf logarithmische Skala gesetzt.

dataindizierbares Objekt, optional

Wenn angegeben, akzeptieren alle Parameter auch eine Zeichenkette s, die als data[s] interpretiert wird, wenn s ein Schlüssel in data ist.

**kwargsRectangle-Eigenschaften

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
`angle`	unknown
`animated`	bool
`antialiased` oder `aa`	bool oder None
`Grenzen`	(links, unten, Breite, Höhe)
`capstyle`	`CapStyle` oder {'butt', 'projecting', 'round'}
`clip_box`	`BboxBase` oder None
`clip_on`	bool
`clip_path`	Patch oder (Path, Transform) oder None
`color`	color
`edgecolor` oder `ec`	Farbe oder None
`facecolor` oder `fc`	Farbe oder None
`figure`	`Figure` oder `SubFigure`
`füllen`	bool
`gid`	str
`Muster (hatch)`	{'/', '\', '\|', '-', '+', 'x', 'o', 'O', '.', '*'}
`hatch_linewidth`	unknown
`Höhe`	unknown
`in_layout`	bool
`joinstyle`	`JoinStyle` oder {'miter', 'round', 'bevel'}
`label`	object
`linestyle` oder `ls`	{'-', '--', '-.', ':', '', (offset, on-off-seq), ...}
`linewidth` oder `lw`	float oder None
`mouseover`	bool
`path_effects`	Liste von `AbstractPathEffect`
`picker`	None oder bool oder float oder callable
`rasterized`	bool
`sketch_params`	(scale: float, length: float, randomness: float)
`snap`	bool oder None
`transform`	`Transform`
`url`	str
`visible`	bool
`width`	unknown
`x`	unknown
`xy`	(float, float)
`y`	unknown
`zorder`	float