matplotlib.axes.Axes.set_prop_cycle

Axes.set_prop_cycle(*args, **kwargs)

Legt den Eigenschaftszyklus der Achsen fest.

Der Eigenschaftszyklus steuert die Stileigenschaften wie Farbe, Markierung und Linienstil zukünftiger Plotbefehle. Die Stileigenschaften von bereits zu den Achsen hinzugefügten Daten werden nicht geändert.

Aufrufsignaturen

set_prop_cycle(cycler)
set_prop_cycle(label=values, label2=values2, ...)
set_prop_cycle(label, values)

Form 1 setzt das gegebene Cycler-Objekt.

Form 2 erstellt einen Cycler, der über eine oder mehrere Eigenschaften gleichzeitig zyklisch wechselt und ihn als Eigenschaftszyklus der Achsen festlegt. Wenn mehrere Eigenschaften angegeben sind, müssen ihre Wertelisten die gleiche Länge haben. Dies ist nur eine Abkürzung für die explizite Erstellung eines Cyclers und dessen Übergabe an die Funktion, d.h. es ist eine Kurzform für set_prop_cycle(cycler(label=values, label2=values2, ...)).

Form 3 erstellt einen Cycler für eine einzelne Eigenschaft und legt ihn als Eigenschaftszyklus der Achsen fest. Diese Form existiert zur Kompatibilität mit der ursprünglichen cycler.cycler-Schnittstelle. Ihre Verwendung wird zugunsten der Keyword-Argument-Form, d.h. set_prop_cycle(label=values), nicht empfohlen.

Parameter:

cyclerCycler oder None

Legt den gegebenen Cycler fest. None setzt den Zyklus auf den durch den aktuellen Stil definierten Zyklus zurück.

labelstr

Der Eigenschaftsschlüssel. Muss eine gültige Artist-Eigenschaft sein. Zum Beispiel 'color' oder 'linestyle'. Aliase sind erlaubt, wie 'c' für 'color' und 'lw' für 'linewidth'.

valuesiterable

Endliche Iterable der Eigenschaftswerte. Diese Werte werden validiert und lösen bei ungültigen Werten einen ValueError aus.

Siehe auch

matplotlib.rcsetup.cycler

Hilfsfunktion zum Erstellen validierter Cycler für Eigenschaften.

cycler.cycler

Die ursprüngliche Funktion zum Erstellen unvalidierter Cycler.

Beispiele

Festlegen des Eigenschaftszyklus für eine einzelne Eigenschaft

>>> ax.set_prop_cycle(color=['red', 'green', 'blue'])

Festlegen des Eigenschaftszyklus für gleichzeitiges Durchlaufen mehrerer Eigenschaften (z.B. roter Kreis, grünes Plus, blauer Kreuz)

>>> ax.set_prop_cycle(color=['red', 'green', 'blue'],
...                   marker=['o', '+', 'x'])

Beispiele für die Verwendung von matplotlib.axes.Axes.set_prop_cycle

Aktienkurse über 32 Jahre

Aktienkurse über 32 Jahre

Styling mit cycler

Styling mit cycler