matplotlib.axes.Axes.barh#

Axes.barh(y, width, height=0.8, left=None, *, align='center', data=None, **kwargs)[Quelle]#

Erzeugt ein horizontales Balkendiagramm.

Die Balken werden bei y mit der gegebenen alignment positioniert. Ihre Abmessungen werden durch width und height gegeben. Die horizontale Grundlinie ist left (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:

yfloat oder array-artig

Die y-Koordinaten der Balken. Siehe auch align für die Ausrichtung der Balken an den Koordinaten.

Balken werden oft für kategoriale Daten verwendet, d.h. String-Labels unter den Balken. Sie können eine Liste von Strings direkt an y übergeben. barh(['A', 'B', 'C'], [1, 2, 3]) ist oft eine kürzere und bequemere Notation im Vergleich zu barh(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 kategorialen y Daten vorhanden sind, werden diese Werte derselben numerischen y-Koordinate zugeordnet, und die entsprechenden Balken werden übereinander gezeichnet.

widthfloat oder array-artig

Die Breite(n) der Balken.

Beachten Sie, dass, wenn left Einheiten hat (z. B. Datum/Zeit), width in Einheiten sein sollte, die eine Differenz vom Wert von left darstellen (z. B. Zeitdifferenz).

heightfloat oder array-artig, Standard: 0.8

Die Höhen der Balken.

Beachten Sie, dass, wenn y Einheiten hat (z. B. Datum/Zeit), dann height in Einheiten sein sollte, die eine Differenz (z. B. Zeitdifferenz) um die y Werte herum darstellen.

leftfloat oder array-artig, Standard: 0

Die x-Koordinaten der linken Seite(n) der Balken.

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

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

Ausrichtung der Basis an den y Koordinaten*

'center': Zentrieren Sie die Balken an den y Positionen.
'edge': Richten Sie die unteren Kanten der Balken an den y Positionen aus.

Um die Balken an der oberen Kante auszurichten, übergeben Sie eine negative height 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.

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 dem resultierenden BarContainer als Label für den gesamten Datensatz angehängt. Wenn eine Liste übergeben wird, muss diese die gleiche Länge wie y haben und beschriftet die einzelnen Balken. Wiederholte Labels werden nicht dedupliziert und führen zu wiederholten Label-Einträgen, daher ist dies am besten geeignet, wenn sich 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: Keine Fehlerleiste. (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 x-Achse als 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

Siehe auch

bar: Zeichnet ein vertikales Balkendiagramm.

Anmerkungen

Gestapelte Balken können durch Übergabe individueller left Werte pro Balken erreicht werden. Siehe Diskrete Verteilung als horizontales Balkendiagramm.