Plongeons dedans.
Syntaxe de la fonction
La fonction fournit une syntaxe simple qui vous permet de vous concentrer sur le code. La syntaxe est exprimée comme ci-dessous :
complot. cette . to_template ( figure , sauter = ( 'Titre' , 'texte' ) )
Les paramètres de la fonction sont :
- Fig - spécifie l'objet figure dont vous souhaitez déplacer le style vers un modèle.
- Ignorer – spécifie une collection de noms des propriétés que vous souhaitez exclure lors du déplacement du style vers un modèle. Par défaut, seule la propriété title est incluse. Cela empêche le texte de la figure, comme les titres des axes, d'être importé par d'autres figures.
La figure renvoie une copie de la figure avec le style déplacé vers un modèle. Le type de retour de go.Figure.
Exemple
Illustrons comment nous pouvons utiliser la fonction to_templed() pour exporter le style d'une figure spécifique vers un modèle.
Commençons par créer une figure avec un style personnalisé. Un exemple de code est illustré ci-dessous :
importer complot. Express comme pixelsdf = px. Les données . iris ( )
figure = px. dispersion ( df , X = 'sépale_longueur' , Oui = 'sépale_largeur' , Couleur = 'espèces' ,
Titre = 'Style personnalisé' )
figue. update_layout (
famille de polices = 'Courrier Nouveau, monospace' ,
couleur de la police = 'rouge' ,
taille de police = 18 ,
title_font_family = 'Times New Roman' ,
title_font_color = 'bleu' ,
légende_titre_font_color = 'vert'
)
figue. update_xaxes ( title_font_family = 'Ariel' )
figue. Afficher ( )
Dans cet exemple, nous créons un nuage de points avec un style de texte personnalisé tel que la famille de police, la couleur de police, la taille de police, etc.
Le code ci-dessus doit renvoyer un simple nuage de points comme indiqué :
Nous pouvons convertir cette figure en une figure avec un modèle de style en utilisant la fonction to_template().
Un exemple de code est comme indiqué :
importer complot. cette comme cettefig_template = cette. to_template ( figure )
Dans le code ci-dessus, nous commençons par importer le module plotly io en tant que io. Nous créons ensuite une copie de la figure avec le style enregistré dans un modèle personnalisé à l'aide de la fonction to_templed().
Nous pouvons afficher le modèle en exécutant le code :
fig_template. disposition . modèleCela devrait renvoyer un dictionnaire avec des propriétés qui définissent le style de la figure. Un exemple de valeur de sortie est comme indiqué :
disposition. Modèle ( {'Les données' : { 'bar' : [ { 'erreur_x' : { 'Couleur' : '#2a3f5f' } ,
'error_y' : { 'Couleur' : '#2a3f5f' } ,
'marqueur' : { 'ligne' : { 'Couleur' : '#E5ECF6' , 'largeur' : 0,5 } ,
'motif' : { 'mode de remplissage' : 'recouvrir' , 'Taille' : dix , 'solidité' : 0,2 } } ,
-------------------------------------------sortie tronquée---------- -------------------------------
Vous pouvez afficher la figure simplement en appelant le modèle enregistré comme :
fig_templateCela devrait afficher la figure enregistrée dans le modèle.
Créer une figure avec le modèle
Une fois que nous avons enregistré le style d'une figure dans un modèle personnalisé, nous pouvons utiliser ce modèle pour appliquer le style à une autre figure.
Un exemple de code est comme indiqué :
importer complot. graph_objectsas allernouvelle_fig = aller. Chiffre ( disposition = {
'modèle' : fig_template. disposition . modèle
} )
nouvelle_fig
Dans l'exemple ci-dessus, nous commençons par importer le module graph_objects de Plotly. Dans ce cas, nous utilisons graph_objects car nous souhaitons créer une figure vide mais n'utilisons que le style.
À l'aide de la fonction go.Figure(), nous passons le paramètre de mise en page et spécifions le modèle cible à l'aide de la propriété 'template'.
Nous pouvons alors afficher la figure résultante en appelant new_fig. Cela devrait retourner :
Notez que la figure ci-dessus ne contient aucune donnée ou texte. Il n'inclut que le style, tel que la couleur du texte, la famille de polices, la taille de la police, etc.
Pour créer un nuage de points avec ce modèle, nous pouvons utiliser le code comme indiqué :
importer complot. graph_objectsas allerimporter numpyas np
N = 1000
t = par exemple. espace lin ( 0 , dix , cinquante )
Oui = par exemple. sans pour autant ( t )
figure = aller. Chiffre ( Les données = aller. Dispersion ( X = t , Oui = Oui , mode = 'Marqueurs' ) , disposition = {
'modèle' : fig_template. disposition . modèle
} )
figue. Afficher ( )
L'exemple ci-dessus doit renvoyer un chiffre comme indiqué :
Notez que la couleur, la famille et la taille de la police sont similaires à celles définies dans le modèle.
Enregistrement d'un modèle nommé
Nous pouvons enregistrer le modèle personnalisé à l'aide de l'objet templates comme indiqué dans le code ci-dessous :
importer complot. cette comme cettecette. modèles [ 'mon_modèle_personnalisé' ] = fig_template. disposition . modèle
Le code ci-dessus enregistrera le modèle sous le nom 'my_custom_template'. Vous pouvez ensuite utiliser ce nom pour spécifier le modèle que vous souhaitez utiliser :
disposition = {'modèle' : 'mon_modèle_personnalisé'
}
Conclusion
Dans ce didacticiel, nous avons appris à créer une figure avec le style enregistré dans un modèle personnalisé. Nous avons également expliqué comment utiliser le modèle dans d'autres figures et enregistrer le modèle pour une utilisation ultérieure.