Plotly.io.to_html

Plotly Io To Html



Hypertext Markup Language ili HTML dokumenti su označni dokumenti koji vam omogućuju prikaz informacija na World Wide Webu. Kada gledate određenu web stranicu, koristite HTML dokument.

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:

  1. Fig – odnosi se na objekt figure ili rječničku reprezentaciju figure.
  2. Config – navodi opcije konfiguracije plotly.js. Proslijedite opcije konfiguracije kao rječnik.
  3. 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.
  4. 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.
  5. include_mathjax – određuje treba li datoteka uključivati ​​biblioteku mathjax.js. Prihvaćene vrijednosti slične su include_plotlyjs osim vrijednosti 'require'.
  6. Post_script – omogućuje vam da uključite isječke JavaScripta koji se pokreću nakon stvaranja crteža.
  7. 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
    .
  8. 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.
  9. Default_width – određuje zadanu širinu rezultirajuće figure u pikselima.
  10. Zadana_visina – određuje zadanu visinu figure u pikselima.
  11. Provjeri valjanost – određuje treba li figuru provjeriti prije pretvaranja u HTML niz.
  12. 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.