Tracer.Io.to_templated

Dans cet article, nous apprendrons à déplacer le style d'une figure d'intrigue vers un modèle spécifique en utilisant la fonction to_templated () f. Vous pouvez ensuite utiliser le modèle pour styliser d'autres chiffres en utilisant la propriété du modèle.

Plongeons-nous dans.

Syntaxe de fonction

La fonction fournit une syntaxe simple qui vous permet de vous concentrer sur le code. La syntaxe est exprimée comme ci-dessous:

tracer.Io.to_templated (fig, skip = ('title', 'text'))

Les paramètres de fonction sont:

1. Fig - Spécifie l'objet Figure dont vous souhaitez passer à un modèle.
2. SKIP - 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é de titre est incluse. Cela empêche le texte de la figure, comme les titres de l'axe, d'être importés par d'autres chiffres.

La figure renvoie une copie de la figure avec le style déplacé vers un modèle. Le type de retour de Go.Chiffre.

Exemple

Illustrons comment nous pouvons utiliser la fonction to_templated () pour exporter le style d'une figure spécifique à un modèle.

Commençons par créer une figure avec un style personnalisé. Un exemple de code est illustré ci-dessous:

Importer un terrain.Exprime comme PX
df = px.données.iris()
Fig = px.disperser (df, x = "sepal_length", y = "sepal_width", color = "espèces",
title = "style personnalisé")
figue.update_layout (
FONT_FAMILY = "COURIER NEW, Monospace",
FONT_COLOR = "Red",
FONT_SIZE = 18,
title_font_family = "Times New Roman",
title_font_color = "bleu",
légende_title_font_color = "vert"
)
figue.update_xaxes (title_font_family = "arial")
figue.montrer()

Dans cet exemple, nous créons un tracé de dispersion avec un style de texte personnalisé tel que la famille des polices, la couleur de la police, la taille de la police, etc.

Le code ci-dessus doit renvoyer un tracé de diffusion simple comme indiqué:

Nous pouvons convertir cette figure en une figure avec un modèle de style utilisant la fonction TO_TEMPLAT ().

Un exemple de code est comme indiqué:

Importer un terrain.Io comme io
Fig_Texlated = io.to_templated (fig)

Dans le code ci-dessus, nous commençons par importer le module IO Plotly comme IO. Nous créons ensuite une copie de la figure avec le style enregistré sur un modèle personnalisé à l'aide de la fonction to_templated ().

Nous pouvons afficher le modèle en exécutant le code:

Fig_Templated.mise en page.modèle

Cela devrait retourner un dictionnaire avec des propriétés qui définissent le style de la figure. Un exemple de valeur de sortie est comme indiqué:

mise en page.Modèle(
'data': 'bar': ['error_x': 'colore': '# 2a3f5f',
'error_y': 'couleur': '# 2a3f5f',
'Marker': 'Line': 'Color': '# e5ecf6', 'width': 0.5,
'modèle': 'fillmode': 'superposition', 'Size': 10, 'Solidity': 0.2,
--------------------------------------sortie tronquée-----------------------------------------

Vous pouvez afficher la figure simplement en appelant le modèle enregistré comme:

Fig_Templated

Cela devrait afficher la figure enregistrée dans le modèle.

Créez une figure avec le modèle

Une fois que nous avons enregistré le style d'une figure à 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 un terrain.graph_objectsas va
new_fig = aller.Figure (Layout =
'Modèle': Fig_Templated.mise en page.modèle
)
new_fig

Dans l'exemple ci-dessus, nous commençons par importer le module Graph_Objects à partir de l'intrigue. Dans ce cas, nous utilisons Graph_Objects car nous souhaitons créer une figure vide mais utilisons uniquement le style.

En utilisant le go.Figure () Fonction, nous passons le paramètre de mise en page et spécifions le modèle cible à l'aide de la propriété «modèle».

Nous pouvons ensuite afficher le chiffre résultant en appelant new_fig. Cela devrait revenir:

Notez que la figure ci-dessus ne contient aucune donnée ou texte. Il comprend uniquement le style, comme la couleur du texte, la famille des polices, la taille de la police, etc.

Pour créer un tracé de diffusion avec ce modèle, nous pouvons utiliser le code comme indiqué:

Importer un terrain.graph_objectsas va
Importer Numpyas NP
N = 1000
t = np.lispace (0, 10, 50)
y = np.péché (t)
Fig = aller.Figure (données = aller.Disperser (x = t, y = y, mode = 'marqueurs'), disposition =
'Modèle': Fig_Templated.mise en page.modèle
)
figue.montrer()

L'exemple ci-dessus doit renvoyer une figure comme indiqué:

Remarque La couleur de la police, la famille et la taille sont similaires à celle définie dans le modèle.

Sauver un modèle nommé

Nous pouvons enregistrer le modèle personnalisé à l'aide de l'objet Modèles comme indiqué dans le code ci-dessous:

Importer un terrain.Io comme io
Io.Templates ['my_custom_template'] = Fig_Templated.mise en page.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': 'my_custom_template'

Conclusion

Dans ce tutoriel, nous avons appris à créer une figure avec le style enregistré sur un modèle personnalisé. Nous avons également couvert comment utiliser le modèle sur d'autres chiffres et enregistrer le modèle pour une utilisation ultérieure.