Să ne scufundăm.
Sintaxa funcției
Funcția oferă o sintaxă simplă care vă permite să vă concentrați asupra codului. Sintaxa este exprimată după cum urmează:
complot. acest . to_template ( Fig , ocolire = ( 'titlu' , 'text' ) )
Parametrii funcției sunt:
- Fig – specifică obiectul figură al cărui stil doriți să îl mutați într-un șablon.
- Skip – specifică o colecție de nume ale proprietăților pe care doriți să le excludeți când mutați stilul într-un șablon. În mod implicit, este inclusă doar proprietatea titlului. Acest lucru împiedică importarea textului figurii, cum ar fi titlurile axelor, de către alte figuri.
Figura returnează o copie a figurii cu stilul mutat într-un șablon. Tipul de returnare a go.Figura.
Exemplu
Să ilustrăm cum putem folosi funcția to_template() pentru a exporta stilul unei anumite figuri într-un șablon.
Să începem prin a crea o siluetă cu stil personalizat. Un exemplu de cod este prezentat mai jos:
import complot. expres la fel de pxdf = px. date . iris ( )
Fig = px. împrăștia ( df , X = „lungimea_sepalului” , Y = 'sepal_width' , culoare = 'specie' ,
titlu = „Stil personalizat” )
Fig. update_layout (
familie de fonturi = „Courier New, monospace” ,
font_color = 'roșu' ,
marimea fontului = 18 ,
title_font_family = 'Times New Roman' ,
title_font_color = 'albastru' ,
legend_title_font_color = 'verde'
)
Fig. update_xaxes ( title_font_family = 'Arial' )
Fig. spectacol ( )
În acest exemplu, creăm un grafic de dispersie cu stil personalizat de text, cum ar fi familia de fonturi, culoarea fontului, dimensiunea fontului etc.
Codul de mai sus ar trebui să returneze un grafic de dispersie simplu, așa cum se arată:
Putem converti această figură într-o figură cu un șablon de stil folosind funcția to_template().
Un exemplu de cod este așa cum se arată:
import complot. acest la fel de acestfig_template = acest. to_template ( Fig )
În codul de mai sus, începem prin a importa modulul plotly io ca io. Apoi creăm o copie a figurii cu stilul salvat într-un șablon personalizat folosind funcția to_template().
Putem vizualiza șablonul rulând codul:
fig_template. aspect . șablonAceasta ar trebui să returneze un dicționar cu proprietăți care definesc stilul figurii. Un exemplu de valoare de ieșire este așa cum se arată:
aspect. Șablon ( {'date' : { 'bar' : [ { „error_x” : { 'culoare' : „#2a3f5f” } ,
„eroare_y” : { 'culoare' : „#2a3f5f” } ,
'marker' : { 'linia' : { 'culoare' : „#E5ECF6” , 'lăţime' : 0,5 } ,
'model' : { 'mod de umplere' : 'acoperire' , 'mărimea' : 10 , 'soliditate' : 0,2 } } ,
-------------------------------------ieșire trunchiată----------- --------------------------------
Puteți afișa figura pur și simplu apelând șablonul salvat ca:
fig_templateAceasta ar trebui să afișeze cifra salvată în șablon.
Creați o figură cu șablonul
Odată ce am salvat stilul unei figuri într-un șablon personalizat, putem folosi acel șablon pentru a aplica stilul unei alte figuri.
Un exemplu de cod este așa cum se arată:
import complot. graph_objectsas mergenou_fig = merge. Figura ( aspect = {
'șablon' : fig_template. aspect . șablon
} )
nou_fig
În exemplul de mai sus, începem prin a importa modulul graph_objects din Plotly. În acest caz, folosim graph_objects deoarece dorim să creăm o figură goală, dar folosim doar stilul.
Folosind funcția go.Figure(), trecem parametrul de aspect și specificăm șablonul țintă folosind proprietatea „șablon”.
Putem afișa apoi cifra rezultată apelând new_fig. Aceasta ar trebui să revină:
Rețineți că figura de mai sus nu conține date sau text. Include doar stilul, cum ar fi culoarea textului, familia de fonturi, dimensiunea fontului etc.
Pentru a crea un grafic de dispersie cu acest șablon, putem folosi codul așa cum se arată:
import complot. graph_objectsas mergeimport numpyas np
N = 1000
t = de exemplu. linspace ( 0 , 10 , cincizeci )
Y = de exemplu. fără ( t )
Fig = merge. Figura ( date = merge. Împrăștia ( X = t , Y = Y , modul = 'marcatoare' ) , aspect = {
'șablon' : fig_template. aspect . șablon
} )
Fig. spectacol ( )
Exemplul de mai sus ar trebui să returneze o cifră așa cum se arată:
Rețineți că culoarea fontului, familia și dimensiunea sunt similare cu cele stabilite în șablon.
Salvarea unui șablon numit
Putem salva șablonul personalizat folosind obiectul șabloane așa cum se arată în codul de mai jos:
import complot. acest la fel de acestacest. șabloane [ „șablonul_personalizat” ] = fig_template. aspect . șablon
Codul de mai sus va salva șablonul sub numele „my_custom_template”. Apoi puteți utiliza acest nume pentru a specifica șablonul pe care doriți să îl utilizați:
aspect = {'șablon' : „șablonul_personalizat”
}
Concluzie
În acest tutorial, am învățat cum să creăm o siluetă cu stilul salvat într-un șablon personalizat. Am explicat, de asemenea, cum să folosiți șablonul în alte figuri și cum să salvați șablonul pentru o utilizare ulterioară.