Immergiamoci.
Sintassi della funzione
La funzione fornisce una semplice sintassi che consente di concentrarsi sul codice. La sintassi è espressa come segue:
tramare. questo . a_modello ( Figura , Salta = ( 'titolo' , 'testo' ) )
I parametri della funzione sono:
- Fig – specifica l'oggetto figura di cui si desidera spostare lo stile in un modello.
- Salta: 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à title. Ciò impedisce che il testo della figura, come i titoli degli assi, venga importato da altre figure.
La figura restituisce una copia della figura con lo stile spostato su un modello. Il tipo restituito di go.Figure.
Esempio
Illustriamo come possiamo usare la funzione to_templated() per esportare lo stile di una figura specifica in un modello.
Iniziamo creando una figura con uno stile personalizzato. Di seguito è riportato un codice di esempio:
importare tramare. esprimere come pxdf = px. dati . iris ( )
Figura = px. dispersione ( df , X = 'lunghezza sepalo' , Y = 'larghezza_sepalo' , colore = 'specie' ,
titolo = 'Stile personalizzato' )
Figura. aggiornamento_layout (
famiglia di font = 'Corriere Nuovo, monospazio' ,
colore del carattere = 'rosso' ,
dimensione del font = 18 ,
title_font_family = 'Times New Roman' ,
title_font_color = 'blu' ,
legend_title_font_color = 'verde'
)
Figura. update_xaxes ( title_font_family = 'Ariale' )
Figura. mostrare ( )
In questo esempio, creiamo un grafico a dispersione con uno stile di testo personalizzato come famiglia di caratteri, colore del carattere, dimensione del carattere, ecc.
Il codice sopra dovrebbe restituire un semplice grafico a dispersione come mostrato:
Possiamo convertire questa figura in una figura con un modello di stile usando la funzione to_template().
Un codice di esempio è come mostrato:
importare tramare. questo come questofig_templated = questo. a_modello ( Figura )
Nel codice sopra, iniziamo importando il modulo plotly io come io. Creiamo quindi una copia della figura con lo stile salvato in un modello personalizzato utilizzando la funzione to_templated().
Possiamo visualizzare il modello eseguendo il codice:
fig_templated. disposizione . modelloQuesto dovrebbe restituire un dizionario con proprietà che definiscono lo stile della figura. Un valore di output di esempio è come mostrato:
disposizione. Modello ( {'dati' : { 'sbarra' : [ { 'errore_x' : { 'colore' : '#2a3f5f' } ,
'errore_y' : { 'colore' : '#2a3f5f' } ,
'marcatore' : { 'linea' : { 'colore' : '#E5ECF6' , 'larghezza' : 0,5 } ,
'modello' : { 'modalità riempimento' : 'sovrapposizione' , 'taglia' : 10 , 'solidità' : 0.2 } } ,
-------------------------------------- uscita troncata ----------- -------------------------------
Puoi visualizzare la figura semplicemente richiamando il modello salvato come:
fig_templatedQuesto dovrebbe visualizzare la figura salvata nel modello.
Crea una figura con il modello
Dopo aver salvato lo stile di una figura in un modello personalizzato, possiamo utilizzare quel modello per applicare lo stile a un'altra figura.
Un codice di esempio è come mostrato:
importare tramare. graph_objectsas andarenuovo_fig = andare. Figura ( disposizione = {
'modello' : fig_modello. disposizione . modello
} )
nuovo_fig
Nell'esempio sopra, iniziamo importando il modulo graph_objects da Plotly. In questo caso, stiamo usando graph_objects perché desideriamo creare una figura vuota ma usiamo solo lo stile.
Usando la funzione go.Figure(), passiamo il parametro layout e specifichiamo il modello di destinazione usando la proprietà 'template'.
Possiamo quindi visualizzare la figura risultante chiamando new_fig. Questo dovrebbe restituire:
Si noti che la figura sopra non contiene dati o testo. Include solo lo stile, come il colore del testo, la famiglia di caratteri, la dimensione del carattere, ecc.
Per creare un grafico a dispersione con questo modello, possiamo utilizzare il codice come mostrato:
importare tramare. graph_objectsas andareimportare numpyas np
N = 1000
t = per esempio. linspace ( 0 , 10 , cinquanta )
Y = per esempio. senza ( t )
Figura = andare. Figura ( dati = andare. Dispersione ( X = t , Y = Y , modalità = 'marcatori' ) , disposizione = {
'modello' : fig_modello. disposizione . modello
} )
Figura. mostrare ( )
L'esempio sopra dovrebbe restituire una figura come mostrato:
Nota che il colore del carattere, la famiglia e la dimensione sono simili a quelli impostati nel modello.
Salvataggio di un modello con nome
Possiamo salvare il modello personalizzato utilizzando l'oggetto modelli come mostrato nel codice seguente:
importare tramare. questo come questoquesto. modelli [ 'il mio_modello_personalizzato' ] = fig_templated. disposizione . modello
Il codice sopra salverà il modello con il nome 'my_custom_template'. È quindi possibile utilizzare questo nome per specificare il modello che si desidera utilizzare:
disposizione = {'modello' : 'il mio_modello_personalizzato'
}
Conclusione
In questo tutorial, abbiamo imparato come creare una figura con lo stile salvato in un modello personalizzato. Abbiamo anche spiegato come utilizzare il modello in altre figure e salvare il modello per un uso successivo.