matplotlib.axes.Axes.violin#

Axes.violin(vpstats, positions=None, *, vert=None, orientation='vertical', widths=0.5, showmeans=False, showextrema=True, showmedians=False, side='both')[source]#

Zeichnet ein Violin-Plot aus vorberechneten Statistiken.

Zeichnet für jede Spalte von vpstats einen Violin-Plot. Jeder gefüllte Bereich erstreckt sich über den gesamten Datenbereich, mit optionalen Linien für Mittelwert, Median, Minimum, Maximum und Quantilwerte.

Parameter:

vpstatsListe von Dictionaries

Eine Liste von Dictionaries, die Statistiken für jeden Violin-Plot enthalten. Erforderliche Schlüssel sind

coords: Eine Liste von Skalaren, die die Koordinaten enthalten, an denen die Kernel-Dichteschätzung des Violins ausgewertet wurde.
vals: Eine Liste von Skalaren, die die Werte der Kernel-Dichteschätzung an jeder der in coords angegebenen Koordinaten enthalten.
mean: Der Mittelwert für den Datensatz dieses Violins.
median: Der Medianwert für den Datensatz dieses Violins.
min: Der Minimalwert für den Datensatz dieses Violins.
max: Der Maximalwert für den Datensatz dieses Violins.

Optionale Schlüssel sind

quantiles: Eine Liste von Skalaren, die die Quantilwerte für den Datensatz dieses Violins enthalten.

positionsarray-like, Standard: [1, 2, ..., n]

Die Positionen der Violinen; d.h. Koordinaten auf der x-Achse für vertikale Violinen (oder y-Achse für horizontale Violinen).

vertbool, optional

Veraltet seit Version 3.10: Verwenden Sie stattdessen orientation.

Wenn dies während der Deputationsperiode angegeben wird, überschreibt es den Parameter orientation.

Wenn True, werden die Violinen vertikal gezeichnet. Wenn False, werden die Violinen horizontal gezeichnet.

orientation{'vertical', 'horizontal'}, Standard: 'vertical'

Wenn 'horizontal', werden die Violinen horizontal gezeichnet. Andernfalls werden die Violinen vertikal gezeichnet.

Hinzugefügt in Version 3.10.

widthsfloat oder array-like, Standard: 0.5

Die maximale Breite jedes Violins in Einheiten der positions-Achse. Der Standardwert ist 0.5, was die halbe verfügbare Fläche bei Verwendung der Standard-positions bedeutet.

showmeansbool, Standard: False

Ob der Mittelwert mit einer Linie angezeigt werden soll.

showextremabool, Standard: True

Ob Extremwerte mit einer Linie angezeigt werden sollen.

showmediansbool, Standard: False

Ob der Median mit einer Linie angezeigt werden soll.

side{'both', 'low', 'high'}, Standard: 'both'

'both' zeichnet Standard-Violinen. 'low'/'high' zeichnet nur die Seite unterhalb/oberhalb des Positions-Wertes.

Gibt zurück:

dict

Ein Dictionary, das jede Komponente des Violinplots einer Liste der entsprechenden erstellten Kollektionsinstanzen zuordnet. Das Dictionary hat die folgenden Schlüssel

bodies: Eine Liste der PolyCollection-Instanzen, die den gefüllten Bereich jeder Violine enthalten.
cmeans: Eine LineCollection-Instanz, die die Mittelwerte jeder Verteilung der Violine markiert.
cmins: Eine LineCollection-Instanz, die das untere Ende jeder Verteilung der Violine markiert.
cmaxes: Eine LineCollection-Instanz, die das obere Ende jeder Verteilung der Violine markiert.
cbars: Eine LineCollection-Instanz, die die Zentren jeder Verteilung der Violine markiert.
cmedians: Eine LineCollection-Instanz, die die Medianwerte jeder Verteilung der Violine markiert.
cquantiles: Eine LineCollection-Instanz, die erstellt wurde, um die Quantilwerte jeder Verteilung des Violins zu identifizieren.

Siehe auch

violinplot: Zeichnet einen Violin-Plot aus Daten anstelle von vorab berechneten Statistiken.