Plotly.io.skriv_html

“HTML -dokumenter er ikke noe nytt. Det er det som krefter internett og alle nettsteder som vi besøker. Derfor vil du komme over tilfeller der du trenger å eksportere en plottfigur til et HTML -dokument. Du kan deretter dele dokumentet eller laste det opp til en webserver som en statisk side.”

I denne artikkelen vil vi utforske hvordan vi kan bruke TO_HTML -funksjonen fra den plottly IO -modulen for å eksportere en figur til en HTML -streng.

Funksjonssyntaks og parameterliste

Funksjonen har en relativt enkel syntaks, som vist nedenfor:

plotly.io.to_html (fig, config = ingen, auto_play = true, include_plotlyjs = true, include_mathjax = falsk, post_script = ingen, full_html = tru div_id = ingen)

Parametere:

1. Fig - spesifiserer figuren som skal konvertere til en HTML -streng.
2. Config - Definerer plottet.JS -konfigurasjonsalternativer.
3. Auto_play - Angir om noen, om noen, skal starte automatisk etter sidebelastning.
4. inkluderer_plotlyjs - definerer metoden som plottet.JS -bibliotek er inkludert i HTML -filen. Aksepterte alternativer inkluderer:
   1. Sann - plotly.JS er inkludert som et skriptetag som inneholder kildekoden for plottet.JS -bibliotek. Dette kan føre til offline bruk av filene, men fører til en stor filstørrelse.
   2. 'CDN' - Dette alternativet inkluderer plottly.JS -bibliotek som et skriptetag som refererer til en CDN -lenke.
   3. 'Katalog' - Hvis den er satt til en katalog, vil funksjonen inkludere plottly.JS -bibliotek som et eksternt plotly.min.JS -pakken lagret i samme katalog som HTML -filen.
   4. 'Krev' - hvis det er satt til å kreve, plottly.JS er lastet ved å bruke krav.JS.
   5. Falske - plotly.JS er ikke inkludert i HTML -filen.
5. inkluderer_mathjax - spesifiserer hvordan Mathjax.JS -bibliotek er inkludert. Aksepterte alternativer ligner på plottet.JS -bibliotek.
6. Post_script - Angir JavaScript -utdragene som er inkludert i Div etter plotoppretting.
7. Full_html - sett hvis funksjonen skal konvertere figuren til et helt HTML -dokument som starter med tagger eller en delvis HTML -streng som starter med elementet.
8. Valider - Angir om figuren skal valideres før konvertering til HTML.

Funksjonen vil deretter returnere en HTML -streng som representerer det spesifiserte figuren.

Lag prøvefigur

Før vi lærer å konvertere en figur til en HTML -streng, la oss ha prøvedata vi kan bruke.

For denne opplæringen vil vi bruke en enkel solbrental som vist i koden nedenfor:

Importer plotly.uttrykk som px
data = dict (
Distros = ['Debian', 'Centos', 'Fedora', 'Red Hat Linux', 'OpenSuse', 'Qubes', 'Suse Studio', 'Ubuntu', 'Kubuntu', 'Xubuntu'],
Foreldre = [", 'Red Hat Linux', 'Red Hat Linux',", 'Red Hat Linux', 'Fedora', 'OpenSuse', 'Debian', 'Ubuntu', 'Ubuntu']
)
Fig = px.SunBurst (data, navn = 'distros', foreldre = 'foreldre', farge = 'distros')
Fig.forestilling()

Koden over skal returnere et tall som vist:

Eksporter figur som HTML -streng

For å eksportere figuren over som en statisk HTML -streng, kan vi kjøre koden som vist:

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

Koden over vil returnere en HTML -streng som representerer ovennevnte Sunburst -plot. Husk at HTML -strengen vil inkludere plottet.JS -bibliotek som CDN som spesifisert ovenfor.

Fra utgangen over kan vi se at HTML -dokumentet starter på elementet.

For å generere et fullt HTML -dokument, kan vi sette full_html -parameteren til True som vist:

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

Lagre HTML -streng til filen

En nyttig funksjon i TO_HTML -funksjonen er å skrive den resulterende HTML -strengen til en HTML -fil.

Et eksempel er som vist:

Importer plotly.io som io
med åpen ('Sunburst.html ',' w ') som f:
f.Skriv (io.to_html (fig, inkluderer_plotlyjs = 'cdn', full_html = true))

Koden over skal skrive HTML -strengen fra TO_HTML -funksjonen i solbrenset.HTML -fil.

Du kan deretter se denne filen ved å åpne den i nettleseren din.

Siden vi inkluderer plotly.JS -bibliotek som CDN, du vil kreve en nettverkstilkobling for biblioteket for å laste ned og få full interaktivitet av figuren.

Konklusjon

I denne artikkelen lærte vi hvordan vi kunne konvertere en plottfigur til en HTML -streng ved hjelp av IO.to_html () funksjon.

Takk for at du leser og lykkelig koding!!