matplotlib.axes.Axes.set_prop_cycle #
- Haches. set_prop_cycle ( * args , ** kwargs ) [source] #
Définissez le cycle de propriétés des axes.
Le cycle de propriétés contrôle les propriétés de style telles que la couleur, le marqueur et le style de ligne des futures commandes de tracé. Les propriétés de style des données déjà ajoutées aux Axes ne sont pas modifiées.
Signatures d'appel :
set_prop_cycle(cycler) set_prop_cycle(label=values[, label2=values2[, ...]]) set_prop_cycle(label, values)
La forme 1 définit un
Cyclerobjet donné.Le formulaire 2 crée un
Cyclercycle sur une ou plusieurs propriétés simultanément et le définit comme cycle de propriété des axes. Si plusieurs propriétés sont données, leurs listes de valeurs doivent avoir la même longueur. C'est juste un raccourci pour créer explicitement un cycleur et le passer à la fonction, c'est-à-dire que c'est l'abréviation de .set_prop_cycle(cycler(label=values label2=values2, ...))Le formulaire 3 crée un
Cyclerpour une seule propriété et le définit comme le cycle de propriété des Axes. Ce formulaire existe pour la compatibilité avec l'cycler.cyclerinterface d'origine. Son utilisation est déconseillée au profit de la forme kwarg, c'est-à-direset_prop_cycle(label=values).- Paramètres :
- cycleur Cycleur
Réglez le cycleur donné. Aucun réinitialise le cycle défini par le style actuel.
- étiquette str
La clé de propriété. Doit être une propriété valide
Artist. Par exemple, 'couleur' ou 'style de ligne'. Les alias sont autorisés, tels que 'c' pour 'color' et 'lw' pour 'linewidth'.- valeurs itérables
Itérable de longueur finie des valeurs de propriété. Ces valeurs sont validées et déclencheront une ValueError si elles sont invalides.
Voir également
matplotlib.rcsetup.cyclerFonction pratique pour créer des cycleurs validés pour les propriétés.
cycler.cyclerLa fonction originale pour créer des cycleurs non validés.
Exemples
Définition du cycle de propriété pour une seule propriété :
>>> ax.set_prop_cycle(color=['red', 'green', 'blue'])
Réglage du cycle de propriétés pour parcourir simultanément plusieurs propriétés (par exemple, cercle rouge, vert plus, croix bleue) :
>>> ax.set_prop_cycle(color=['red', 'green', 'blue'], ... marker=['o', '+', 'x'])
