Plotly.io.to_html

Hypertekst markeringsspråk eller HTML -dokumenter er markeringsdokumenter som lar deg vise informasjon på World Wide Web. Når du ser på et bestemt nettsted, bruker du et HTML -dokument.

Det er derfor ingen overraskelse at du kanskje trenger å konvertere en spesifikk plottfigur til en HTML -streng.

I denne opplæringen lærer vi hvordan du bruker den plottly IO -modulen for å konvertere en figur til en HTML -strengrepresentasjon.

La oss dykke inn.

Plotly.io.to_html () funksjon

TO_HTML () -funksjonen fra Plotlys IO -modul lar deg passere en spesifikk figur som en parameter og konvertere den til en HTML -streng.

Funksjonssyntaksen uttrykkes som vist nedenfor:

plotly.io.to_html (fig, config = ingen, auto_play = true, include_plotlyjs = true, clas div_id = ingen)

La oss utforske funksjonsparametrene nedenfor:

1. Fig - refererer til figurobjektet eller ordboksrepresentasjonen av figuren.
2. Konfigurasjon - spesifiserer plottly.JS -konfigurasjonsalternativer. Passere konfigurasjonsalternativene som ordbok.
3. Auto_play - Bestemmer om animasjonssekvensen skal spille automatisk på siden Load. Denne parameteren er nyttig hvis du har en figur som inneholder animerte rammer.
4. Inkluderer_plotlyjs - Denne parameteren spesifiserer hvordan plottet.JS -bibliotek er inkludert i HTML. Aksepterte verdier i denne parameteren inkluderer:
   • Sann - inkluderer plotly.JS -bibliotek som et skriptetag i HTML -dokumentet. Dette vil øke filstørrelsen, men lar filen brukes i offline miljøer.
   • 'CDN' - Angi parameteren Inkludert.JS -bibliotek. Bruk dette alternativet når du er i et nettverksmiljø eller filstørrelsesfølsom miljø.
   • 'Directory' - Inkluderer en skriptetag som peker på en ekstern plottly.min.JS -pakken som ligger i samme katalog som HTML -dokumentet.
   • 'Krev' - Å sette verdien som krever vil laste plottet.JS -bibliotek ved å bruke krav.JS. Forsikre deg om det.JS er installert og tilgjengelig globalt på systemet.
   • 'Falsk' - inkluderer ikke plottet.JS -bibliotek. Unngå denne verdien når du setter full_html -parameteren til True, da det vil gjengi hele dokumentet, ubrukelig.
5. inkluderer_mathjax - Angir om filen skal omfatte Mathjax.JS -bibliotek. Aksepterte verdier ligner på inkluderer_plotlyjs bortsett fra 'krever' verdi.
6. Post_script - lar deg inkludere JavaScript -utdrag som blir utført etter plottopprettelsen.
7. Full_html - Hvis sant, vil funksjonen returnere en streng som inneholder hele HTML -dokumentet, og starter med taggene. Hvis falsk, vil funksjonen returnere en HTML -streng som starter med elementet.
8. Animation_opts - lar deg spesifisere tilpassede animasjonsegenskaper som ordbok. Disse verdiene blir deretter sendt til plottet.Animer funksjon i plotly.JS.
9. Standard_Width - Angir standardbredden på den resulterende figuren i piksler.
10. Default_Height - Angir standardhøyden på figuren i piksler.
11. Valider - bestemmer om figuren skal valideres før det blir konvertert til en HTML -streng.
12. Div_id - Angir en verdi av ID -attributtet til DIV -taggen der plottet er lokalisert.

Deretter returnerer funksjonen en strengrepresentasjon av figuren som en streng.

Eksempelbruk

Følgende kode viser hvordan du bruker TO_HTML -funksjonen for å konvertere en figur til en HTML -strengrepresentasjon.

Importer plotly.uttrykk som px
df = px.data.Aksjer (indeksert = sant)
Fig = px.Område (DF, FACET_COL = 'Company', FACET_COL_WRAP = 2)
Fig.forestilling()

I eksemplet over begynner vi med å importere plottly ekspressmodulen som PX. Vi oppretter deretter en dataramme ved hjelp av lagerdataene fra plott.

Til slutt lager vi en fasettert områdeplott ved hjelp av PX.områdefunksjon. Dette skal returnere en figur som vist nedenfor:

Vi kan konvertere figuren ovenfor til en HTML -strengrepresentasjon som vist i koden nedenfor:

Importer plotly.io som io
io.to_html (fig, full_html = falsk)

Å kjøre koden over skal returnere en massiv HTML -streng som vist på skjermdumpen nedenfor:

Merk at HTML -dokumentet starter på elementet. Hvis du vil inkludere hele HTML -filen, må du angi parameteren Full_HTML = True som vist:

Importer plotly.io som io
io.to_html (fig, full_html = true)

Legg merke til at markeringen starter på taggen.

Å inkludere plotly.JS, vi kan sette parameteren som:

Importer plotly.io som io
io.to_html (fig, inkluderer_plotlyjs = 'cdn', full_html = true)

I eksemplet over forteller vi funksjonen om å inkludere plottet.JS -bibliotek via en CDN -lenke.

Vi kan bekrefte dette fra utdataene nedenfor:

Den beste måten å bruke TO_HTML -dokumentet er ved å eksportere HTML -strengen til en HTML -fil.

Vi kan gjøre dette ved å kjøre en enkel kode som vist nedenfor:

Importer plotly.io som io
med åpen ('fasettert.html ',' w ') som f:
f.Writelines (IO.to_html (fig, inkluderer_plotlyjs = 'cnd', full_html = true))

I dette eksemplet bruker vi filmodulen i Python for å skrive HTML -strengen som en HTML -fil.

Vi kan deretter åpne HTML -dokumentet i nettleseren og se figuren som vist:

Konklusjon

Gratulerer, du har eksportert din plottfigur som en HTML -streng ved å bruke plottet.io.TO_HTML -funksjon.