Poglobimo se.
Sintaksa funkcije
Funkcija ponuja preprosto sintakso, ki vam omogoča, da se osredotočite na kodo. Sintaksa je izražena kot spodaj:
zapleteno. to . to_templated ( fig , preskoči = ( 'naslov' , 'besedilo' ) )
Funkcijski parametri so:
- Fig – določa predmet figure, katerega slog želite premakniti v predlogo.
- Preskoči – določa zbirko imen lastnosti, ki jih želite izključiti pri premikanju sloga v predlogo. Privzeto je vključena samo lastnost naslova. To preprečuje, da bi druge figure uvozile besedilo slike, kot so naslovi osi.
Slika vrne kopijo figure s slogom, premaknjenim v predlogo. Vrnitev vrste go.Figure.
Primer
Naj ponazorimo, kako lahko uporabimo funkcijo to_templated() za izvoz sloga določene figure v predlogo.
Začnimo z ustvarjanjem figure s stilom po meri. Primer kode je prikazan spodaj:
uvoz zapleteno. ekspresno kot pxdf = px. podatke . iris ( )
fig = px. razpršiti ( df , x = 'sepal_length' , Y = 'sepal_width' , barva = 'vrsta' ,
naslov = 'Stajling po meri' )
fig. posodobitev_postavitve (
družina_pisav = 'Courier New, monospace' ,
barva_pisave = 'rdeča' ,
velikost pisave = 18 ,
title_font_family = 'Times New Roman' ,
barva_pisave naslova = 'modra' ,
legenda_naslov_barva_pisave = 'zelena'
)
fig. posodobitev_xaxes ( title_font_family = 'Arial' )
fig. pokazati ( )
V tem primeru ustvarimo razpršeni grafikon s slogom besedila po meri, kot so družina pisav, barva pisave, velikost pisave itd.
Zgornja koda bi morala vrniti preprost razpršeni grafikon, kot je prikazano:
To figuro lahko pretvorimo v figuro s predlogo za slog s funkcijo to_template().
Primer kode je prikazan:
uvoz zapleteno. to kot tofig_templated = to. to_templated ( fig )
V zgornji kodi začnemo z uvozom modula plotly io kot io. Nato s funkcijo to_templated() ustvarimo kopijo slike s slogom, shranjenim v predlogo po meri.
Predlogo si lahko ogledamo tako, da zaženemo kodo:
fig_templated. postavitev . predlogoTo bi moralo vrniti slovar z lastnostmi, ki določajo slog figure. Primer izhodne vrednosti je, kot je prikazano:
postavitev. Predloga ( {'podatki' : { 'bar' : [ { 'error_x' : { 'barva' : '#2a3f5f' } ,
'error_y' : { 'barva' : '#2a3f5f' } ,
'marker' : { 'line' : { 'barva' : '#E5ECF6' , 'premer' : 0,5 } ,
'vzorec' : { 'fillmode' : 'overlay' , 'velikost' : 10 , 'trdnost' : 0,2 } } ,
-------------------------------------izhod prirezan---------- ------------------------------
Sliko lahko preprosto prikažete tako, da pokličete shranjeno predlogo kot:
fig_templatedTo bi moralo prikazati sliko, shranjeno v predlogi.
Ustvarite figuro s predlogo
Ko shranimo slog figure v predlogo po meri, lahko s to predlogo uporabimo slog za drugo sliko.
Primer kode je prikazan:
uvoz zapleteno. graph_objectsas pojdinova_fig = pojdi. Slika ( postavitev = {
'template' : fig_templated. postavitev . predlogo
} )
nova_fig
V zgornjem primeru začnemo z uvozom modula graph_objects iz Plotly. V tem primeru uporabljamo graph_objects, saj želimo ustvariti prazno figuro, vendar uporabimo samo slog.
S funkcijo go.Figure() posredujemo parameter postavitve in določimo ciljno predlogo z lastnostjo 'template'.
Nato lahko prikažemo nastalo sliko s klicem new_fig. To bi moralo vrniti:
Upoštevajte, da zgornja slika ne vsebuje nobenih podatkov ali besedila. Vključuje samo slog, kot je barva besedila, družina pisav, velikost pisave itd.
Za ustvarjanje razpršenega grafa s to predlogo lahko uporabimo prikazano kodo:
uvoz zapleteno. graph_objectsas pojdiuvoz numpyas np
n = 1000
t = npr. linspace ( 0 , 10 , petdeset )
Y = npr. brez ( t )
fig = pojdi. Slika ( podatke = pojdi. Razpršenost ( x = t , Y = Y , način = 'markerji' ) , postavitev = {
'template' : fig_templated. postavitev . predlogo
} )
fig. pokazati ( )
Zgornji primer bi moral vrniti sliko, kot je prikazano:
Upoštevajte, da so barva, družina in velikost pisave podobni tistim v predlogi.
Shranjevanje imenovane predloge
Predlogo po meri lahko shranimo z uporabo predmeta predloge, kot je prikazano v spodnji kodi:
uvoz zapleteno. to kot toto. predloge [ 'my_custom_template' ] = fig_templated. postavitev . predlogo
Zgornja koda bo shranila predlogo pod imenom 'my_custom_template'. Nato lahko s tem imenom določite predlogo, ki jo želite uporabiti:
postavitev = {'template' : 'my_custom_template'
}
Zaključek
V tej vadnici smo se naučili, kako ustvariti figuro s slogom, shranjenim v predlogi po meri. Opisali smo tudi, kako uporabiti predlogo v drugih slikah in shraniti predlogo za kasnejšo uporabo.