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 % pctformatiert. 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
Noneist.- 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
Nonegesetzt, werden die Beschriftungen nicht gezeichnet, aber für die Verwendung inlegendgespeichert.- 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.Wedgedes Kreises übergeben werden. Zum Beispiel setztwedgeprops = {'linewidth': 3}die Breite der Keilrandlinien auf 3. Standardmäßig istclip_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) == 1gilt. False erstellt einen Teilkreis, wennsum(x) <= 1und löst einenValueErroraus fürsum(x) > 1.- dataindizierbares Objekt, optional
Wenn angegeben, akzeptieren die folgenden Parameter auch einen String
s, der alsdata[s]interpretiert wird, wennsein Schlüssel indataistx, 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_aspectgesteuert werden.