Zato ni presenetljivo, da boste morda morali pretvoriti določeno sliko Plotly v niz HTML.
V tej vadnici se bomo naučili, kako uporabiti modul Plotly io za pretvorbo figure v predstavitev niza HTML.
Poglobimo se.
Funkcija Plotly.io.to_html().
Funkcija to_html() iz Plotlyjevega modula io vam omogoča, da posredujete določeno številko kot parameter in jo pretvorite v niz HTML.
Sintaksa funkcije je izražena, kot je prikazano spodaj:
zapleteno. to . na_html ( fig , konfiguracija = Noben , samodejno predvajanje = Prav , include_plotlyjs = Prav , include_mathjax = False , post_script = Noben , full_html = Prav , animation_opts = Noben , privzeta_širina = '100 %' , privzeta_višina = '100 %' , potrditi = Prav , div_id = Noben )
Raziščimo parametre funkcije spodaj:
- Fig – nanaša se na predmet figure ali slovarsko predstavitev figure.
- Config – določa konfiguracijske možnosti plotly.js. Posredujte konfiguracijske možnosti kot slovar.
- Auto_play – določa, ali naj se zaporedje animacij samodejno predvaja ob nalaganju strani. Ta parameter je uporaben, če imate figuro, ki vsebuje animirane okvirje.
- Include_plotlyjs – ta parameter določa, kako je knjižnica plotly.js vključena v HTML. Sprejete vrednosti v tem parametru vključujejo:
- True – vključuje knjižnico plotly.js kot oznako skripta v dokumentu HTML. To bo povečalo velikost datoteke, vendar bo omogočilo uporabo datoteke v okoljih brez povezave.
- 'cdn' – nastavitev parametra include_plotlyjs na 'cdn' bo dodala oznako skripta, ki kaže na oddaljeno povezavo za knjižnico plotly.js. To možnost uporabite, ko ste v omrežnem okolju ali okolju, ki je občutljivo na velikost datoteke.
- ‘imenik’ – vključuje oznako skripta, ki kaže na zunanji sveženj plotly.min.js, ki se nahaja v istem imeniku kot dokument HTML.
- 'require' – nastavitev vrednosti na require bo naložila knjižnico plotly.js z uporabo require.js. Zagotovite, da je require.js nameščen in na voljo globalno v sistemu.
- »False« – ne vključuje knjižnice plotly.js. Izogibajte se tej vrednosti, ko nastavite parameter full_html na True, saj bo celoten dokument postal neuporaben.
- include_mathjax – določa, ali naj datoteka vključuje knjižnico mathjax.js. Sprejete vrednosti so podobne include_plotlyjs, razen vrednosti »require«.
- Post_script – omogoča vključitev izrezkov JavaScript, ki se izvedejo po ustvarjanju risbe.
- Full_html – če je res, bo funkcija vrnila niz, ki vsebuje celoten dokument HTML, začenši z oznakama . Če je nastavljeno na false, bo funkcija vrnila niz HTML, ki se začne z elementom .
- Animation_opts – omogoča, da določite lastnosti animacije po meri kot slovar. Te vrednosti se nato posredujejo funkciji plotly.animate v plotly.js.
- Default_width – podaja privzeto širino nastale figure v slikovnih pikah.
- Privzeta_višina – določa privzeto višino figure v slikovnih pikah.
- Preveri – določa, ali je treba sliko preveriti pred pretvorbo v niz HTML.
- Div_id – podaja vrednost atributa id oznake div, kjer se nahaja izris.
Nato funkcija vrne nizovno predstavitev figure kot niz.
Primer uporabe
Naslednja koda prikazuje, kako s funkcijo to_html pretvoriti sliko v predstavitev niza HTML.
uvoz zapleteno. ekspresno kot px
df = px. podatke . zaloge ( indeksirano = Prav )
fig = px. območje ( df , faset_col = 'podjetje' , facet_col_wrap = dva )
fig. pokazati ( )V zgornjem primeru začnemo z uvozom modula Plotly express kot px. Nato ustvarimo podatkovni okvir z uporabo podatkov o zalogi iz Plotly.
Nazadnje ustvarimo fasetirano površino s funkcijo px.area. To bi moralo vrniti sliko, kot je prikazano spodaj:
Zgornjo sliko lahko pretvorimo v predstavitev niza HTML, kot je prikazano v spodnji kodi:
uvoz zapleteno. to kot to
to. na_html ( fig , full_html = False )Zagon zgornje kode bi moral vrniti ogromen niz HTML, kot je prikazano na spodnjem posnetku zaslona:
Upoštevajte, da se dokument HTML začne pri elementu
. Če želite vključiti celotno datoteko HTML, nastavite parameter full_html=True, kot je prikazano: uvoz zapleteno. to kot to
to. na_html ( fig , full_html = Prav )
Upoštevajte, da se oznaka začne pri oznaki .
Če želite vključiti plotly.js, lahko parameter nastavimo kot:
uvoz zapleteno. to kot to
to. na_html ( fig , include_plotlyjs = 'cdn' , full_html = Prav )V zgornjem primeru rečemo funkciji, naj vključi knjižnico plotly.js prek povezave CDN.
To lahko preverimo iz spodnjega rezultata:
Najboljši način za uporabo dokumenta to_html je izvoz niza HTML v datoteko HTML.
To lahko storimo tako, da zaženemo preprosto kodo, kot je prikazano spodaj:
uvoz zapleteno. to kot to
z odprto ( 'facetted.html' , 'noter' ) kot f:
f. pisne vrstice ( to. na_html ( fig , include_plotlyjs = 'cnd' , full_html = Prav ) )V tem primeru uporabljamo datotečni modul v Pythonu za pisanje niza HTML kot datoteke html.
Nato lahko odpremo dokument HTML v brskalniku in si ogledamo sliko, kot je prikazano:
Zaključek
Čestitamo, svojo sliko Plotly ste uspešno izvozili kot niz HTML s funkcijo plotly.io.to_html.