merüljünk bele.
Függvény szintaxis
A funkció egy egyszerű szintaxist biztosít, amely lehetővé teszi, hogy a kódra összpontosítson. A szintaxis az alábbiak szerint van kifejezve:
cselekményesen. ez . to_template ( ábra , kihagyni = ( 'cím' , 'szöveg' ) )
A funkció paraméterei a következők:
- Fig – meghatározza azt az alakobjektumot, amelynek stílusát át szeretné helyezni egy sablonba.
- Kihagyás – meghatározza azon tulajdonságok nevének gyűjteményét, amelyeket ki szeretne zárni, amikor a stílust áthelyezi egy sablonba. Alapértelmezés szerint csak a title tulajdonság szerepel benne. Ez megakadályozza, hogy az ábra szövegét, például a tengelycímeket más ábrák importálják.
Az ábra az ábra másolatát adja vissza úgy, hogy a stílust egy sablonba helyezték át. A visszatérés típusa megy.ábra.
Példa
Mutatjuk, hogyan tudjuk a to_templated() függvénnyel exportálni egy adott ábra stílusát egy sablonba.
Kezdjük egy figura létrehozásával egyedi stílussal. Az alábbiakban egy példakód látható:
import cselekményesen. Expressz mint pxdf = px. adat . írisz ( )
ábra = px. szétszór ( df , x = 'sepal_length' , Y = 'sepal_width' , szín = 'faj' ,
cím = 'Egyedi stílus' )
ábra. update_layout (
betűtípus család = 'Courier New, monospace' ,
betű szín = 'piros' ,
betűméret = 18 ,
title_font_family = 'Times New Roman' ,
title_font_color = 'kék' ,
legend_title_font_color = 'zöld'
)
ábra. update_xaxes ( title_font_family = 'Arial' )
ábra. előadás ( )
Ebben a példában szóródási diagramot hozunk létre egyéni szövegstílussal, például betűcsaláddal, betűszínnel, betűmérettel stb.
A fenti kódnak egy egyszerű szórásdiagramot kell visszaadnia, az ábrán látható módon:
Ezt az ábrát a to_template() függvény segítségével stílussablonnal alakíthatjuk figurává.
Egy példakód a következő:
import cselekményesen. ez mint ezfig_template = ez. to_template ( ábra )
A fenti kódban a plotly io modul importálásával kezdjük io néven. Ezután a to_templated() függvény segítségével elkészítjük az ábra másolatát a stílussal egy egyéni sablonba mentve.
A sablont a kód futtatásával tekinthetjük meg:
fig_template. elrendezés . sablonEnnek egy szótárt kell visszaadnia olyan tulajdonságokkal, amelyek meghatározzák az ábra stílusát. Egy példa kimeneti érték a következő:
elrendezés. Sablon ( {'adat' : { 'rúd' : [ { 'hiba_x' : { 'szín' : '#2a3f5f' } ,
'hiba_y' : { 'szín' : '#2a3f5f' } ,
'jelző' : { 'vonal' : { 'szín' : '#E5ECF6' , 'szélesség' : 0.5 } ,
'minta' : { 'fillmode' : 'overlay' , 'méret' : 10 , 'szilárdság' : 0.2 } } ,
--------------------------------------kimenet csonka---------- -------------------------------
Az ábrát egyszerűen a mentett sablon meghívásával jelenítheti meg:
fig_templateEnnek meg kell jelennie a sablonban elmentett ábrának.
Hozzon létre egy ábrát a sablonnal
Miután elmentettük egy figura stílusát egy egyéni sablonba, akkor ezzel a sablonnal alkalmazhatjuk a stílust egy másik figurára.
Egy példakód a következő:
import cselekményesen. graph_objectsas megynew_fig = megy. Ábra ( elrendezés = {
'sablon' : fig_template. elrendezés . sablon
} )
new_fig
A fenti példában a graph_objects modul importálásával kezdjük a Plotly-ból. Ebben az esetben a graph_objects-t használjuk, mivel üres ábrát szeretnénk létrehozni, de csak a stílust használjuk.
A go.Figure() függvény segítségével átadjuk a layout paramétert, és a ‘template’ tulajdonság segítségével megadjuk a célsablont.
Ezután a kapott ábrát a new_fig meghívásával megjeleníthetjük. Ennek vissza kell térnie:
Vegye figyelembe, hogy a fenti ábra nem tartalmaz adatokat vagy szöveget. Csak a stílust tartalmazza, például a szöveg színét, a betűcsaládot, a betűméretet stb.
Szórványdiagram létrehozásához ezzel a sablonnal a következő kódot használhatjuk:
import cselekményesen. graph_objectsas megyimport numpyas np
N = 1000
t = például. linspace ( 0 , 10 , ötven )
Y = például. nélkül ( t )
ábra = megy. Ábra ( adat = megy. Szétszór ( x = t , Y = Y , mód = 'jelzők' ) , elrendezés = {
'sablon' : fig_template. elrendezés . sablon
} )
ábra. előadás ( )
A fenti példának a képen látható ábrát kell visszaadnia:
Vegye figyelembe, hogy a betűtípus színe, családja és mérete hasonló a sablonban megadotthoz.
Elnevezett sablon mentése
Az egyéni sablont a sablon objektum segítségével menthetjük az alábbi kód szerint:
import cselekményesen. ez mint ezez. sablonokat [ 'saját_egyéni_sablon' ] = fig_template. elrendezés . sablon
A fenti kód „saját_egyéni_sablon” néven menti a sablont. Ezután ezt a nevet használhatja a használni kívánt sablon meghatározásához:
elrendezés = {'sablon' : 'saját_egyéni_sablon'
}
Következtetés
Ebben az oktatóanyagban megtanultuk, hogyan hozhat létre figurát egyéni sablonba mentett stílussal. Kitértünk arra is, hogyan használhatjuk a sablont más ábrákon, és hogyan mentsük el a sablont későbbi használatra.