Stoga ne čudi da ćete možda morati pretvoriti određenu Plotly figuru u HTML niz.
U ovom vodiču naučit ćemo kako koristiti Plotly io modul za pretvaranje figure u HTML prikaz niza.
Zaronimo.
Funkcija Plotly.io.to_html().
Funkcija to_html() iz Plotlyjevog io modula omogućuje vam da proslijedite određenu brojku kao parametar i pretvorite je u HTML niz.
Sintaksa funkcije izražena je kao što je prikazano u nastavku:
zapletno. ovaj . to_html ( smokva , konfiguracija = Nijedan , auto Play = Pravi , uključi_plotlyj = Pravi , uključi_mathjax = lažno , post_script = Nijedan , puni_html = Pravi , opcije_animacije = Nijedan , zadana_širina = '100%' , zadana_visina = '100%' , potvrditi = Pravi , div_id = Nijedan )
Istražimo parametre funkcije u nastavku:
- Fig – odnosi se na objekt figure ili rječničku reprezentaciju figure.
- Config – navodi opcije konfiguracije plotly.js. Proslijedite opcije konfiguracije kao rječnik.
- Auto_play – određuje treba li se sekvenca animacije automatski reproducirati pri učitavanju stranice. Ovaj je parametar koristan ako imate lik koji sadrži animirane okvire.
- Include_plotlyjs – ovaj parametar određuje kako je biblioteka plotly.js uključena u HTML. Prihvaćene vrijednosti u ovom parametru uključuju:
- Istina – uključuje biblioteku plotly.js kao oznaku skripte u HTML dokumentu. Ovo će povećati veličinu datoteke, ali će omogućiti korištenje datoteke u izvanmrežnim okruženjima.
- ‘cdn’ – postavljanje parametra include_plotlyjs na ‘cdn’ će dodati oznaku skripte koja upućuje na udaljenu vezu za biblioteku plotly.js. Koristite ovu opciju kada ste u umreženom okruženju ili okruženju osjetljivom na veličinu datoteke.
- ‘direktorij’ – uključuje oznaku skripte koja upućuje na vanjski paket plotly.min.js koji se nalazi u istom direktoriju kao i HTML dokument.
- 'require' – postavljanje vrijednosti na require će učitati biblioteku plotly.js koristeći require.js. Provjerite je li require.js instaliran i dostupan globalno na sustavu.
- ‘False’ – ne uključuje biblioteku plotly.js. Izbjegavajte ovu vrijednost kada parametar full_html postavljate na True jer će cijeli dokument učiniti neupotrebljivim.
- include_mathjax – određuje treba li datoteka uključivati biblioteku mathjax.js. Prihvaćene vrijednosti slične su include_plotlyjs osim vrijednosti 'require'.
- Post_script – omogućuje vam da uključite isječke JavaScripta koji se pokreću nakon stvaranja crteža.
- Full_html – ako je true, funkcija će vratiti niz koji sadrži cijeli HTML dokument, počevši od oznaka . Ako je false, funkcija će vratiti HTML niz koji počinje elementom .
- Animation_opts – omogućuje vam da odredite prilagođena svojstva animacije kao rječnik. Te se vrijednosti zatim prosljeđuju funkciji plotly.animate u plotly.js.
- Default_width – određuje zadanu širinu rezultirajuće figure u pikselima.
- Zadana_visina – određuje zadanu visinu figure u pikselima.
- Provjeri valjanost – određuje treba li figuru provjeriti prije pretvaranja u HTML niz.
- Div_id – navodi vrijednost id atributa div oznake gdje se iscrtavanje nalazi.
Zatim funkcija vraća nizovnu reprezentaciju figure kao niz.
Primjer upotrebe
Sljedeći kôd pokazuje kako koristiti funkciju to_html za pretvaranje figure u HTML prikaz niza.
uvoz zapletno. izraziti kao px
df = px. podaci . dionice ( indeksirano = Pravi )
smokva = px. područje ( df , faset_col = 'društvo' , facet_col_wrap = dva )
smokva pokazati ( )U gornjem primjeru započinjemo s uvozom Plotly express modula kao px. Zatim stvaramo podatkovni okvir koristeći podatke o dionicama iz Plotlyja.
Na kraju, pomoću funkcije px.area stvaramo fasetiranu površinu. Ovo bi trebalo vratiti lik kao što je prikazano u nastavku:
Gornju sliku možemo pretvoriti u HTML prikaz niza kao što je prikazano u donjem kodu:
uvoz zapletno. ovaj kao ovaj
ovaj. to_html ( smokva , puni_html = lažno )Pokretanje gornjeg koda trebalo bi vratiti masivni HTML niz kao što je prikazano na slici ispod:
Imajte na umu da HTML dokument počinje elementom
. Ako želite uključiti cijelu HTML datoteku, postavite parametar full_html=True kao što je prikazano: uvoz zapletno. ovaj kao ovaj
ovaj. to_html ( smokva , puni_html = Pravi )Primijetite da oznaka počinje od oznake .
Da uključimo plotly.js, možemo postaviti parametar kao:
uvoz zapletno. ovaj kao ovaj
ovaj. to_html ( smokva , uključi_plotlyj = 'cdn' , puni_html = Pravi )U gornjem primjeru kažemo funkciji da uključi biblioteku plotly.js putem CDN veze.
To možemo potvrditi iz rezultata u nastavku:
Najbolji način korištenja to_html dokumenta je izvoz HTML niza u HTML datoteku.
To možemo učiniti pokretanjem jednostavnog koda kao što je prikazano u nastavku:
uvoz zapletno. ovaj kao ovaj
s otvorena ( 'facetted.html' , 'u' ) kao f:
f. redovi pisanja ( ovaj. to_html ( smokva , uključi_plotlyj = 'cnd' , puni_html = Pravi ) )U ovom primjeru koristimo modul datoteke u Pythonu za pisanje HTML niza kao HTML datoteke.
Tada možemo otvoriti HTML dokument u pregledniku i pogledati sliku kao što je prikazano:
Zaključak
Čestitamo, uspješno ste izvezli svoju Plotly figuru kao HTML niz pomoću funkcije plotly.io.to_html.