matplotlib.pyplot.barh

matplotlib.pyplot.barh(y, width, height=0.8, left=None, *, align='center', data=None, **kwargs)

Erzeugt ein horizontales Balkendiagramm.

Die Balken werden mit der gegebenen Ausrichtung bei y positioniert. Ihre Abmessungen werden durch width und height bestimmt. Die horizontale Basislinie 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 zu 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 den kategorialen y-Daten vorhanden sind, werden diese Werte derselben numerischen y-Koordinate zugeordnet, und die entsprechenden Balken werden übereinander gezeichnet.

widthfloat oder array-ähnlich

Die Breite(n) der Balken.

Beachten Sie, dass wenn left Einheiten hat (z.B. Datum/Zeit), width in Einheiten angegeben werden sollte, die eine Differenz zum Wert von left darstellen (z.B. Zeitintervall).

heightfloat oder array-ähnlich, Standard: 0.8

Die Höhen der Balken.

Beachten Sie, dass wenn y Einheiten hat (z.B. Datum/Zeit), height in Einheiten angegeben werden sollte, die eine Differenz (z.B. Zeitintervall) um die y-Werte herum darstellen.

leftfloat oder array-ähnlich, Standard: 0

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

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

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

Ausrichtung der Basis an den y-Koordinaten*

• 'center': Zentriert die Balken auf den y-Positionen.

• 'edge': Richtet 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 Balkenoberflä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 zugeordnet. 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 wird dies am besten verwendet, 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: 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 auf logarithmische Skalierung 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

Hinweis

Dies ist der pyplot-Wrapper für axes.Axes.barh.

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

Beispiele für die Verwendung von matplotlib.pyplot.barh

Balkendiagramm mit Beschriftungen

Balkendiagramm mit Beschriftungen

Diskrete Verteilung als horizontales Balkendiagramm

Diskrete Verteilung als horizontales Balkendiagramm

Mehrere Histogramme nebeneinander

Mehrere Histogramme nebeneinander