Sukellaan sisään.
Funktion syntaksi
Toiminto tarjoaa yksinkertaisen syntaksin, jonka avulla voit keskittyä koodiin. Syntaksi ilmaistaan seuraavasti:
juonimainen. Tämä . to_template ( kuva , ohita = ( 'titteli' , 'teksti' ) )
Toimintoparametrit ovat:
- Fig – määrittää kuvioobjektin, jonka tyylin haluat siirtää malliin.
- Ohita – määrittää kokoelman ominaisuuksien nimiä, jotka haluat sulkea pois siirtäessäsi tyyliä malliin. Oletusarvoisesti vain otsikkoominaisuus on mukana. Tämä estää kuvan tekstiä, kuten akselien otsikoita, tuomasta toisia kuvioita.
Figuuri palauttaa kopion kuviosta, jonka tyyli on siirretty malliin. Palautustyyppi go.Kuva.
Esimerkki
Havainnollistetaan, kuinka voimme käyttää to_templated()-funktiota tietyn kuvion tyylin viemiseen malliin.
Aloitetaan luomalla figuuri mukautetulla tyylillä. Alla on esimerkkikoodi:
tuonti juonimainen. ilmaista kuten pxdf = px. tiedot . iiris ( )
kuva = px. hajaantua ( df , x = 'sepal_length' , Y = 'sepal_width' , väri- = 'laji' ,
otsikko = 'Mukautettu tyyli' )
kuva update_layout (
font_family = 'Courier New, monospace' ,
fontin väri = 'punainen' ,
Fonttikoko = 18 ,
title_font_family = 'Times New Roman' ,
title_font_color = 'sininen' ,
legend_title_font_color = 'vihreä'
)
kuva update_xaxes ( title_font_family = 'Arial' )
kuva näytä ( )
Tässä esimerkissä luomme hajontakaavion mukautetulla tekstityylillä, kuten kirjasinperheellä, kirjasimen värillä, fontilla jne.
Yllä olevan koodin pitäisi palauttaa yksinkertainen sirontakaavio kuvan mukaisesti:
Voimme muuntaa tämän kuvion kuvioksi tyylimallilla käyttämällä to_template()-funktiota.
Esimerkkikoodi on seuraavanlainen:
tuonti juonimainen. Tämä kuten Tämäfig_template = Tämä. to_template ( kuva )
Yllä olevassa koodissa aloitamme tuomalla plotly io -moduulin nimellä io. Luomme sitten kopion kuviosta, jonka tyyli on tallennettu mukautettuun malliin käyttämällä to_templated()-funktiota.
Voimme tarkastella mallia suorittamalla koodin:
fig_template. layout . sapluunaTämän pitäisi palauttaa sanakirja, jossa on ominaisuuksia, jotka määrittävät kuvion tyylin. Esimerkki lähtöarvosta on seuraavanlainen:
layout. Sapluuna ( {'data' : { 'baari' : [ { 'error_x' : { 'väri' : '#2a3f5f' } ,
'error_y' : { 'väri' : '#2a3f5f' } ,
'merkki' : { 'linja' : { 'väri' : '#E5ECF6' , 'leveys' : 0.5 } ,
'kuvio' : { 'fillmode' : 'peitto' , 'koko' : 10 , 'kiinteys' : 0.2 } } ,
---------------------------------------lähtö katkaistu----------- -------------------------------
Voit näyttää kuvan yksinkertaisesti kutsumalla tallennettua mallia seuraavasti:
fig_templateTämän pitäisi näyttää malliin tallennettu luku.
Luo kuvio mallin avulla
Kun olemme tallentaneet hahmon tyylin mukautettuun malliin, voimme käyttää tätä mallia tyylin soveltamiseen toiseen figuuriin.
Esimerkkikoodi on seuraavanlainen:
tuonti juonimainen. graph_objectsas mennäuusi_kuva = mennä. Kuva ( layout = {
'sapluuna' : fig_template. layout . sapluuna
} )
uusi_kuva
Yllä olevassa esimerkissä aloitamme tuomalla graph_objects -moduulin Plotlysta. Tässä tapauksessa käytämme graph_objects -funktiota, koska haluamme luoda tyhjän kuvion, mutta käytämme vain tyyliä.
Go.Figue()-funktion avulla välitämme asetteluparametrin ja määritämme kohdemallin käyttämällä ominaisuutta 'template'.
Voimme sitten näyttää tuloksena olevan luvun kutsumalla new_fig. Tämän pitäisi palata:
Huomaa, että yllä oleva kuva ei sisällä mitään tietoja tai tekstiä. Se sisältää vain tyylin, kuten tekstin värin, kirjasinperheen, kirjasinkoon jne.
Luodaksemme sirontakuvaajan tällä mallilla, voimme käyttää koodia kuvan mukaisesti:
tuonti juonimainen. graph_objectsas mennätuonti numpyas np
N = 1000
t = esim. linspace ( 0 , 10 , viisikymmentä )
Y = esim. ilman ( t )
kuva = mennä. Kuva ( tiedot = mennä. Hajaantua ( x = t , Y = Y , tila = 'merkit' ) , layout = {
'sapluuna' : fig_template. layout . sapluuna
} )
kuva näytä ( )
Yllä olevan esimerkin pitäisi palauttaa kuvan mukainen luku:
Huomaa, että fontin väri, perhe ja koko ovat samanlaiset kuin mallissa.
Nimetyn mallin tallentaminen
Voimme tallentaa mukautetun mallin käyttämällä malliobjektia alla olevan koodin mukaisesti:
tuonti juonimainen. Tämä kuten TämäTämä. malleja [ 'my_custom_template' ] = fig_template. layout . sapluuna
Yllä oleva koodi tallentaa mallin nimellä 'my_custom_template'. Voit sitten käyttää tätä nimeä määrittääksesi mallin, jota haluat käyttää:
layout = {'sapluuna' : 'my_custom_template'
}
Johtopäätös
Tässä opetusohjelmassa opimme luomaan hahmon, jonka tyyli on tallennettu mukautettuun malliin. Käsittelimme myös mallin käyttöä muissa kuvissa ja mallin tallentamista myöhempää käyttöä varten.