Submergem-nos.
Sintaxi de la funció
La funció proporciona una sintaxi senzilla que us permet centrar-vos en el codi. La sintaxi s'expressa de la següent manera:
trama. això . a_plantilla ( fig , Omet = ( 'títol' , 'text' ) )
Els paràmetres de la funció són:
- Fig: especifica l'objecte de la figura l'estil del qual voleu moure a una plantilla.
- Omet: especifica una col·lecció de noms de les propietats que voleu excloure en moure l'estil a una plantilla. Per defecte, només s'inclou la propietat del títol. Això evita que el text de la figura, com ara els títols dels eixos, sigui importat per altres figures.
La figura retorna una còpia de la figura amb l'estil mogut a una plantilla. El tipus de retorn de go.Figura.
Exemple
Il·lustrem com podem utilitzar la funció to_template() per exportar l'estil d'una figura específica a una plantilla.
Comencem per crear una figura amb un estil personalitzat. A continuació es mostra un codi d'exemple:
importar trama. expressar com pxdf = px. dades . iris ( )
fig = px. dispersió ( df , x = 'longitud_sèpal' , i = 'amplada_sèpal' , color = 'espècie' ,
títol = 'Estil personalitzat' )
fig. actualització_disposició (
font_family = 'Courier Nou, monoespai' ,
color de la lletra = 'vermell' ,
mida de la font = 18 ,
title_font_family = 'Times New Roman' ,
title_font_color = 'blau' ,
legend_title_font_color = 'verd'
)
fig. update_xaxes ( title_font_family = 'Arial' )
fig. espectacle ( )
En aquest exemple, creem un diagrama de dispersió amb un estil de text personalitzat, com ara família de tipus de lletra, color de lletra, mida de lletra, etc.
El codi anterior hauria de retornar un diagrama de dispersió simple com es mostra:
Podem convertir aquesta figura en una figura amb una plantilla d'estil mitjançant la funció to_template().
Un exemple de codi és el que es mostra:
importar trama. això com aixòfig_template = això. a_plantilla ( fig )
Al codi anterior, comencem important el mòdul plotly io com a io. A continuació, creem una còpia de la figura amb l'estil desat en una plantilla personalitzada mitjançant la funció to_template().
Podem veure la plantilla executant el codi:
fig_template. maquetació . plantillaAixò hauria de retornar un diccionari amb propietats que defineixin l'estil de la figura. Un exemple de valor de sortida és el que es mostra:
maquetació. Plantilla ( {'dades' : { 'bar' : [ { 'error_x' : { 'color' : '#2a3f5f' } ,
'error_y' : { 'color' : '#2a3f5f' } ,
'marcador' : { 'línia' : { 'color' : '#E5ECF6' , 'amplada' : 0.5 } ,
'patró' : { 'mode d'ompliment' : 'superposició' , 'mida' : 10 , 'solidesa' : 0.2 } } ,
-------------------------------------sortida truncada----------- --------------------------------
Podeu mostrar la figura simplement trucant a la plantilla desada com:
fig_templateAixò hauria de mostrar la figura desada a la plantilla.
Creeu una figura amb la plantilla
Un cop hem desat l'estil d'una figura en una plantilla personalitzada, podem utilitzar aquesta plantilla per aplicar l'estil a una altra figura.
Un exemple de codi és el que es mostra:
importar trama. objectes_gràfics anarnova_fig = anar. Figura ( maquetació = {
'plantilla' : fig_template. maquetació . plantilla
} )
nova_fig
A l'exemple anterior, comencem important el mòdul graph_objects de Plotly. En aquest cas, estem utilitzant graph_objects perquè volem crear una figura buida però només utilitzem l'estil.
Mitjançant la funció go.Figure(), passem el paràmetre de disseny i especifiquem la plantilla de destinació mitjançant la propietat 'template'.
Aleshores podem mostrar la figura resultant cridant a new_fig. Això hauria de tornar:
Tingueu en compte que la figura anterior no conté cap dada ni text. Només inclou l'estil, com ara el color del text, la família de tipus de lletra, la mida de la lletra, etc.
Per crear un diagrama de dispersió amb aquesta plantilla, podem utilitzar el codi tal com es mostra:
importar trama. objectes_gràfics anarimportar numpyas np
N = 1000
t = per exemple. linspace ( 0 , 10 , 50 )
i = per exemple. sense ( t )
fig = anar. Figura ( dades = anar. Dispersió ( x = t , i = i , mode = 'marcadors' ) , maquetació = {
'plantilla' : fig_template. maquetació . plantilla
} )
fig. espectacle ( )
L'exemple anterior hauria de retornar una figura com es mostra:
Tingueu en compte que el color, la família i la mida del tipus de lletra són similars al que s'estableix a la plantilla.
Desar una plantilla amb nom
Podem desar la plantilla personalitzada utilitzant l'objecte plantilles tal com es mostra al codi següent:
importar trama. això com aixòaixò. plantilles [ 'la meva_plantilla_personalitzada' ] = fig_template. maquetació . plantilla
El codi anterior desarà la plantilla amb el nom 'my_custom_template'. A continuació, podeu utilitzar aquest nom per especificar la plantilla que voleu utilitzar:
maquetació = {'plantilla' : 'la meva_plantilla_personalitzada'
}
Conclusió
En aquest tutorial, hem après a crear una figura amb l'estil desat en una plantilla personalitzada. També vam explicar com utilitzar la plantilla en altres figures i desar-la per utilitzar-la posteriorment.