Plotly.io.to_templated

In questo articolo, impareremo come spostare lo styling di una figura tramante in un modello specifico usando la funzione F To_Templated (). È quindi possibile utilizzare il modello per modellare altre figure usando la proprietà del modello.

Immerciamoci.

Sintassi della funzione

La funzione fornisce una semplice sintassi che consente di concentrarti sul codice. La sintassi è espressa come di seguito:

Plotly.io.to_templated (fig, skip = ('title', 'text'))

I parametri della funzione sono:

1. Fig - Specifica l'oggetto di figura di cui si desidera passare a un modello.
2. Skip - Specifica una raccolta di nomi delle proprietà che si desidera escludere quando si sposta lo stile in un modello. Per impostazione predefinita, è inclusa solo la proprietà del titolo. Ciò impedisce il testo della figura, come i titoli degli assi, di essere importato da altre figure.

La figura restituisce una copia della figura con lo stile spostato in un modello. Il tipo di ritorno di Go.Figura.

Esempio

Illustriamo come possiamo usare la funzione TO_Templated () per esportare lo styling di una figura specifica in un modello.

Cominciamo creando una figura con uno stile personalizzato. Un codice di esempio è mostrato di seguito:

importazione della trama.esprimere come px
df = px.dati.iris()
FIG = px.Scatter (df, x = "sepal_length", y = "sepal_width", color = "specie",
title = "Styling personalizzato")
Fico.update_layout (
font_family = "Courier New, Monospace",
font_color = "rosso",
font_size = 18,
title_font_family = "Times New Roman",
title_font_color = "blu",
Legend_title_font_color = "Green"
)
Fico.update_xaxes (title_font_family = "Arial")
Fico.spettacolo()

In questo esempio, creiamo un diagramma a dispersione con uno stile di testo personalizzato come la famiglia dei caratteri, il colore dei caratteri, le dimensioni del carattere, ecc.

Il codice sopra dovrebbe restituire un semplice diagramma a dispersione come mostrato:

Possiamo convertire questa figura in una figura con un modello di styling usando la funzione To_Template ().

Un codice di esempio è come mostrato:

importazione della trama.io come io
fig_templated = io.to_templated (fig)

Nel codice sopra, iniziamo importando il modulo Plotly IO come IO. Creiamo quindi una copia della figura con lo styling salvato su un modello personalizzato utilizzando la funzione TO_Templated ().

Possiamo visualizzare il modello eseguendo il codice:

fig_templated.disposizione.modello

Questo dovrebbe restituire un dizionario con proprietà che definiscono lo stile della figura. Un valore di output di esempio è come mostrato:

disposizione.Modello(
'Data': 'Bar': ['Error_x': 'Color': '#2a3f5f',
'ERROR_Y': 'Color': '#2a3f5f',
'marcatore': 'riga': 'color': '#e5ecf6', 'width': 0.5,
'pattern': 'fillmode': 'overlay', 'size': 10, 'solidità': 0.2,
--------------------------------------output troncato-----------------------------------------

È possibile visualizzare la figura semplicemente chiamando il modello salvato come:

fig_templated

Questo dovrebbe visualizzare la figura salvata nel modello.

Crea una figura con il modello

Una volta che abbiamo salvato lo styling di una figura su un modello personalizzato, possiamo usare quel modello per applicare lo stile a un'altra figura.

Un codice di esempio è come mostrato:

importazione della trama.Graph_Objectsas Go
new_fig = go.Figura (layout =
'modello': fig_templated.disposizione.modello
)
new_fig

Nell'esempio sopra, iniziamo importando il modulo Graph_Objects da Plotly. In questo caso, stiamo usando graph_objects poiché desideriamo creare una figura vuota ma usiamo solo lo stile.

Usando il Go.Figura () Funzione, passiamo il parametro di layout e specifichiamo il modello di destinazione usando la proprietà "modello".

Possiamo quindi visualizzare la figura risultante chiamando new_fig. Questo dovrebbe tornare:

Si noti che la figura sopra non contiene dati o testo. Include solo lo stile, come il colore del testo, la famiglia dei caratteri, le dimensioni del carattere, ecc.

Per creare un diagramma a dispersione con questo modello, possiamo usare il codice come mostrato:

importazione della trama.Graph_Objectsas Go
Importa Numpyas NP
N = 1000
t = np.Linspace (0, 10, 50)
y = np.sin (t)
FIG = GO.Figura (data = go.SPIREST (x = t, y = y, modalità = 'marker'), layout =
'modello': fig_templated.disposizione.modello
)
Fico.spettacolo()

L'esempio sopra dovrebbe restituire una figura come mostrato:

Nota il colore del carattere, la famiglia e le dimensioni sono simili a quello impostato nel modello.

Salvare un modello nominato

Possiamo salvare il modello personalizzato utilizzando l'oggetto Modelli come mostrato nel codice seguente:

importazione della trama.io come io
io.modelli ['my_custom_template'] = fig_templated.disposizione.modello

Il codice sopra salvi il modello con il nome "my_custom_template". È quindi possibile utilizzare questo nome per specificare il modello che si desidera utilizzare:

layout =
'Template': 'my_custom_template'

Conclusione

In questo tutorial, abbiamo imparato a creare una figura con lo stile salvato su un modello personalizzato. Abbiamo anche trattato come utilizzare il modello in altre figure e salvare il modello per un uso successivo.