Poďme sa ponoriť.
Syntax funkcie
Funkcia poskytuje jednoduchú syntax, ktorá vám umožňuje sústrediť sa na kód. Syntax je vyjadrená takto:
zápletka. toto . to_templated ( obr , preskočiť = ( 'názov' , 'text' ) )
Parametre funkcie sú:
- Fig – určuje objekt postavy, ktorého štýl chcete presunúť do šablóny.
- Preskočiť – určuje kolekciu názvov vlastností, ktoré chcete vylúčiť pri presúvaní štýlu do šablóny. Štandardne je zahrnutá iba vlastnosť title. To zabraňuje tomu, aby sa text obrázku, ako napríklad názvy osí, importoval inými obrázkami.
Obrázok vráti kópiu obrázka so štýlom presunutým do šablóny. Návratový typ pohybu.Obrázok.
Príklad
Ukážme si, ako môžeme použiť funkciu to_templated() na exportovanie štýlu konkrétnej postavy do šablóny.
Začnime vytvorením postavy s vlastným štýlom. Príklad kódu je uvedený nižšie:
importovať zápletka. expresné ako pxdf = px. údajov . dúhovka ( )
obr = px. rozhadzovať ( df , X = 'sepal_length' , Y = 'sepal_width' , farba = 'druh' ,
titul = 'Vlastný štýl' )
obr. update_layout (
font_family = 'Kurier New, monospace' ,
farba písma = 'červená' ,
veľkosť písma = 18 ,
title_font_family = 'Times New Roman' ,
názov_farba_písma = 'Modrá' ,
legenda_title_font_color = 'zelená'
)
obr. update_xaxes ( title_font_family = 'Arial' )
obr. šou ( )
V tomto príklade vytvoríme bodový graf s vlastným štýlom textu, ako je rodina písma, farba písma, veľkosť písma atď.
Vyššie uvedený kód by mal vrátiť jednoduchý bodový graf, ako je znázornené:
Túto figúrku môžeme pomocou funkcie to_template() previesť na figúrku so štýlovou šablónou.
Príklad kódu je takýto:
importovať zápletka. toto ako totofig_templated = toto. to_templated ( obr )
Vo vyššie uvedenom kóde začneme importovaním modulu plotly io ako io. Potom vytvoríme kópiu obrázku so štýlom uloženým do vlastnej šablóny pomocou funkcie to_templated().
Šablónu môžeme zobraziť spustením kódu:
fig_templated. rozloženie . šablónaTo by malo vrátiť slovník s vlastnosťami, ktoré definujú štýl postavy. Príklad výstupnej hodnoty je uvedený:
rozloženie. Šablóna ( {'data' : { 'bar' : [ { 'error_x' : { 'farba' : '#2a3f5f' } ,
'error_y' : { 'farba' : '#2a3f5f' } ,
'marker' : { 'riadok' : { 'farba' : '#E5ECF6' , 'šírka' : 0,5 } ,
'vzor' : { 'fillmode' : 'overlay' , 'veľkosť' : 10 , 'pevnosť' : 0,2 } } ,
-------------------------------------- výstup skrátený---------- -------------------------------
Obrázok môžete jednoducho zobraziť volaním uloženej šablóny ako:
fig_templatedToto by malo zobraziť číslo uložené v šablóne.
Vytvorte figúrku pomocou šablóny
Po uložení štýlu postavy do vlastnej šablóny môžeme túto šablónu použiť na aplikáciu štýlu na inú postavu.
Príklad kódu je takýto:
importovať zápletka. graph_objectsas ísťnový_obr = ísť. Obrázok ( rozloženie = {
'šablóna' : fig_templated. rozloženie . šablóna
} )
nový_obr
Vo vyššie uvedenom príklade začneme importovaním modulu graph_objects z Plotly. V tomto prípade používame graph_objects, pretože chceme vytvoriť prázdnu postavu, ale použijeme iba štýl.
Pomocou funkcie go.Figure() odovzdáme parameter layout a pomocou vlastnosti ‘template’ určíme cieľovú šablónu.
Výsledný údaj potom môžeme zobraziť volaním new_fig. Toto by sa malo vrátiť:
Upozorňujeme, že obrázok vyššie neobsahuje žiadne údaje ani text. Zahŕňa iba štýl, ako je farba textu, rodina písma, veľkosť písma atď.
Na vytvorenie bodového grafu s touto šablónou môžeme použiť kód, ako je znázornené:
importovať zápletka. graph_objectsas ísťimportovať numpyas np
N = 1000
t = napr. linspace ( 0 , 10 , päťdesiat )
Y = napr. bez ( t )
obr = ísť. Obrázok ( údajov = ísť. Rozptyľovať ( X = t , Y = Y , režim = 'markery' ) , rozloženie = {
'šablóna' : fig_templated. rozloženie . šablóna
} )
obr. šou ( )
Vyššie uvedený príklad by mal vrátiť číslo, ako je znázornené:
Všimnite si, že farba, rodina a veľkosť písma sú podobné tým, ktoré sú nastavené v šablóne.
Uloženie pomenovanej šablóny
Vlastnú šablónu môžeme uložiť pomocou objektu šablón, ako je znázornené v kóde nižšie:
importovať zápletka. toto ako totototo. šablóny [ 'my_custom_template' ] = fig_templated. rozloženie . šablóna
Vyššie uvedený kód uloží šablónu pod názvom „my_custom_template“. Tento názov potom môžete použiť na určenie šablóny, ktorú chcete použiť:
rozloženie = {'šablóna' : 'my_custom_template'
}
Záver
V tomto návode sme sa naučili, ako vytvoriť postavu so štýlom uloženým do vlastnej šablóny. Tiež sme sa zaoberali tým, ako použiť šablónu na iných obrázkoch a uložiť šablónu na neskoršie použitie.