matplotlib.axes.Axes.pie#

Axes.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 Kreisdiagramm aus dem Array x. Der Bruchteil der Fläche jedes Keils wird durch x/sum(x) gegeben.

Die Keile werden standardmäßig gegen den Uhrzeigersinn gezeichnet, beginnend auf der x-Achse.

Parameter:
x1D Array-ähnlich

Die Größen der Keile.

explodeArray-ähnlich, Standard: None

Wenn nicht None, ist dies ein Array der Länge len(x), das den Bruchteil des Radius angibt, um den jeder Keil versetzt wird.

labelsListe, Standard: None

Eine Sequenz von Zeichenketten, die die Beschriftungen für jeden Keil liefert.

colorsFarbe oder Liste von Farben, Standard: None

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

hatchZeichenkette oder Liste, Standard: None

Schraffurmuster, das auf alle Kreissegmente 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, ist autopct eine Zeichenkette oder Funktion, die verwendet wird, um die Keile mit ihrem numerischen Wert zu beschriften. Die Beschriftung wird im Keil platziert. Wenn autopct eine Formatzeichenkette ist, wird die Beschriftung als fmt % pct formatiert. Wenn autopct eine Funktion ist, wird diese aufgerufen.

pctdistanceFloat, Standard: 0.6

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

labeldistanceFloat oder None, Standard: 1.1

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

shadowBool oder dict, Standard: False

Wenn Bool, wird ein Schatten unter dem Kreis gezeichnet. Wenn dict, wird ein Schatten gezeichnet, indem die Eigenschaften im dict an Shadow übergeben werden.

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

startangleFloat, Standard: 0 Grad

Der Winkel, um den der Start des Kreises gedreht wird, gegen den Uhrzeigersinn von der x-Achse.

radiusFloat, Standard: 1

Der Radius des Kreises.

counterclockBool, 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 Kreises übergeben werden. Zum Beispiel setzt wedgeprops = {'linewidth': 3} die Breite der Keilrandlinien auf 3. Standardmäßig ist clip_on=False. Bei Konflikten zwischen diesen Eigenschaften und anderen Schlüsselwörtern 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.

frameBool, Standard: False

Zeichnet den Achsenrahmen mit dem Diagramm, wenn True.

rotatelabelsBool, Standard: False

Dreht jede Beschriftung im Winkel des entsprechenden Segments, wenn True.

normalizeBool, Standard: True

Wenn True, wird immer ein vollständiger Kreis gezeichnet, indem x normalisiert wird, so dass sum(x) == 1 gilt. False erstellt einen Teilkreis, wenn sum(x) <= 1 und löst einen ValueError aus für sum(x) > 1.

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. Dies wird nur zurückgegeben, wenn der Parameter autopct nicht None ist.

Anmerkungen

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

Beispiele für die Verwendung von matplotlib.axes.Axes.pie#

SVG-Filter Kreis

SVG-Filter Kreis

Balken eines Kreises

Balken eines Kreises

Verschachtelte Kreisdiagramme

Verschachtelte Kreisdiagramme

Ein Kreis und ein Donut mit Beschriftungen

Ein Kreis und ein Donut mit Beschriftungen

Kreisdiagramme

Kreisdiagramme

pie(x)

pie(x)