matplotlib.pyplot.pie#

matplotlib.pyplot.pie(x, *, explode=None, labels=None, colors=None, autopct=None, pctdistance=0.6, shadow=False, labeldistance=1.1, startangle=0, radius=1, counterclock=True, wedgeprops=None, textprops=None, center=(0, 0), frame=False, rotatelabels=False, normalize=True, hatch=None, data=None)[Quelle]#

Erzeugt ein Tortendiagramm.

Erstellt ein Tortendiagramm aus dem Array x. Der Bruchteil der Fläche jedes Sektors wird durch x/sum(x) gegeben.

Die Sektoren werden standardmäßig gegen den Uhrzeigersinn von der x-Achse aus geplottet.

Parameter:

x1D Array-ähnlich

Die Größen der Sektoren.

explodeArray-ähnlich, Standard: None

Wenn nicht None, dann ein Array der Länge len(x), das den Bruchteil des Radius angibt, mit dem jeder Sektor versetzt wird.

labelsListe, Standard: None

Eine Sequenz von Zeichenketten, die die Beschriftungen für jeden Sektor bereitstellt.

colorsFarbe oder Liste von Farben, Standard: None

Eine Sequenz von Farben, durch die das Tortendiagramm zyklisch durchläuft. Wenn None, werden die Farben des aktuell aktiven Zyklus verwendet.

hatchZeichenkette oder Liste, Standard: None

Schraffurmuster, das auf alle Tortendiagramm-Sektoren angewendet wird, oder eine Sequenz von Mustern, durch die das Diagramm zyklisch durchläuft. Eine Liste gültiger Muster finden Sie in der Referenz für Schraffurstile.

Hinzugefügt in Version 3.7.

autopctNone oder Zeichenkette oder aufrufbar, Standard: None

Wenn nicht None, dann ist autopct eine Zeichenkette oder Funktion, die verwendet wird, um die Sektoren mit ihrem numerischen Wert zu beschriften. Die Beschriftung wird innerhalb des Sektors platziert. Wenn autopct eine Formatierungszeichenkette ist, ist die Beschriftung fmt % pct. Wenn autopct eine Funktion ist, wird diese aufgerufen.

pctdistanceGleitkommazahl, Standard: 0.6

Der relative Abstand entlang des Radius, an dem der von autopct generierte Text gezeichnet wird. Um den Text außerhalb des Tortendiagramms zu zeichnen, setzen Sie pctdistance > 1. Dieser Parameter wird ignoriert, wenn autopct None ist.

labeldistanceGleitkommazahl oder None, Standard: 1.1

Der relative Abstand entlang des Radius, an dem die Beschriftungen gezeichnet werden. Um die Beschriftungen innerhalb des Tortendiagramms zu zeichnen, setzen Sie labeldistance < 1. Wenn auf None gesetzt, werden Beschriftungen nicht gezeichnet, aber für die Verwendung in legend gespeichert.

shadowBoolesch oder dict, Standard: False

Wenn Boolesch, ob ein Schatten unter dem Tortendiagramm gezeichnet werden soll. Wenn dict, wird ein Schatten gezeichnet, wobei die Eigenschaften im dict an Shadow übergeben werden.

Hinzugefügt in Version 3.8: shadow kann ein dict sein.

startangleGleitkommazahl, Standard: 0 Grad

Der Winkel, um den der Anfang des Tortendiagramms gedreht wird, gegen den Uhrzeigersinn von der x-Achse aus.

radiusFloat, Standard: 1

Der Radius des Tortendiagramms.

counterclockBoolesch, Standard: True

Gibt die Richtung der Brüche an, im oder gegen den Uhrzeigersinn.

wedgepropsdict, Standard: None

Dict mit Argumenten, die an jeden patches.Wedge des Tortendiagramms übergeben werden. Zum Beispiel setzt wedgeprops = {'linewidth': 3} die Breite der Randlinien der Sektoren auf 3. Standardmäßig ist clip_on=False. Wenn es einen Konflikt zwischen diesen Eigenschaften und anderen Schlüsselwörtern gibt, haben die an wedgeprops übergebenen Eigenschaften Vorrang.

textpropsdict, Standard: None

Dict mit Argumenten, die an die Textobjekte übergeben werden.

center(Float, Float), Standard: (0, 0)

Die Koordinaten des Mittelpunkts des Diagramms.

frameBoolesch, Standard: False

Zeichnet den Achsenrahmen mit dem Diagramm, wenn wahr.

rotatelabelsBoolesch, Standard: False

Dreht jede Beschriftung auf den Winkel des entsprechenden Sektors, wenn wahr.

normalizeBoolesch, Standard: True

Wenn True, wird immer ein vollständiges Tortendiagramm erstellt, indem x normalisiert wird, sodass sum(x) == 1 ist. False erstellt ein teilweises Tortendiagramm, wenn sum(x) <= 1 und löst einen ValueError für sum(x) > 1 aus.

dataindizierbares Objekt, optional

Wenn angegeben, akzeptieren die folgenden Parameter auch einen String s, der als data[s] interpretiert wird, wenn s ein Schlüssel in data ist

x, explode, labels, colors

Gibt zurück:

patchesListe: Eine Sequenz von matplotlib.patches.Wedge-Instanzen.
textsListe: Eine Liste der Beschriftungs-Text-Instanzen.
autotextsListe: Eine Liste von Text-Instanzen für die numerischen Beschriftungen. Diese wird nur zurückgegeben, wenn der Parameter autopct nicht None ist.

Anmerkungen

Hinweis

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

Das Tortendiagramm sieht wahrscheinlich am besten aus, wenn die Figur und die Achsen quadratisch sind oder das Achsenverhältnis gleich ist. Diese Methode setzt das Achsenverhältnis auf "equal". Das Achsenverhältnis kann mit Axes.set_aspect gesteuert werden.