Det er derfor ingen overraskelse at du kanskje må konvertere en spesifikk Plotly-figur til en HTML-streng.
I denne opplæringen lærer vi hvordan du bruker Plotly io-modulen til å 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 sende en spesifikk figur som en parameter og konvertere den til en HTML-streng.
Funksjonssyntaksen uttrykkes som vist nedenfor:
plottende. dette . til_html ( Fig , konfig = Ingen , Auto spill = ekte , include_plotlyjs = ekte , include_mathjax = Falsk , post_script = Ingen , full_html = ekte , animasjon_opts = Ingen , default_width = '100%' , default_height = '100%' , validere = ekte , div_id = Ingen )
La oss utforske funksjonsparametrene nedenfor:
- Fig – refererer til figurobjektet eller ordbokrepresentasjonen av figuren.
- Config – spesifiserer plotly.js-konfigurasjonsalternativene. Send konfigurasjonsalternativene som en ordbok.
- Auto_play – bestemmer om animasjonssekvensen skal spilles av automatisk ved sideinnlastingen. Denne parameteren er nyttig hvis du har en figur som inneholder animerte rammer.
- Include_plotlyjs – denne parameteren spesifiserer hvordan plotly.js-biblioteket er inkludert i HTML-en. Godkjente verdier i denne parameteren inkluderer:
- True – inkluderer plotly.js-biblioteket som en skriptkode i HTML-dokumentet. Dette vil øke filstørrelsen, men vil tillate at filen kan brukes i frakoblede miljøer.
- ‘cdn’ – å sette include_plotlyjs-parameteren til ‘cdn’ vil legge til en script-tag som peker til en ekstern lenke for plotly.js-biblioteket. Bruk dette alternativet når du er i et nettverksmiljø eller filstørrelsessensitivt miljø.
- ‘katalog’ – inkluderer en skriptkode som peker til en ekstern plotly.min.js-pakke som ligger i samme katalog som HTML-dokumentet.
- ‘require’ – å sette verdien til require vil laste plotly.js-biblioteket ved å bruke require.js. Sørg for at require.js er installert og tilgjengelig globalt på systemet.
- ‘False’ – inkluderer ikke plotly.js-biblioteket. Unngå denne verdien når du setter full_html-parameteren til True, da den vil gjøre hele dokumentet ubrukelig.
- include_mathjax – spesifiserer om filen skal inkludere mathjax.js-biblioteket. Aksepterte verdier ligner på include_plotlyjs bortsett fra 'require'-verdien.
- Post_script – lar deg inkludere JavaScript-kodebiter som kjøres etter plottopprettingen.
- Full_html – hvis sant, vil funksjonen returnere en streng som inneholder hele HTML-dokumentet, og starter med -taggene. Hvis false, vil funksjonen returnere en HTML-streng som starter med -elementet.
- Animation_opts – lar deg spesifisere egendefinerte animasjonsegenskaper som en ordbok. Disse verdiene sendes deretter til plotly.animate-funksjonen i plotly.js.
- Default_width – angir standardbredden til den resulterende figuren i piksler.
- Default_height – angir standardhøyden på figuren i piksler.
- Valider – bestemmer om figuren skal valideres før den konverteres til en HTML-streng.
- Div_id – spesifiserer en verdi av id-attributtet til div-taggen der plottet er plassert.
Deretter returnerer funksjonen en strengrepresentasjon av figuren som en streng.
Eksempel på bruk
Følgende kode viser hvordan du bruker to_html-funksjonen til å konvertere en figur til en HTML-strengrepresentasjon.
import plottende. uttrykke som px
df = px. data . aksjer ( indeksert = ekte )
Fig = px. område ( df , facet_col = 'selskap' , facet_col_wrap = to )
Fig. forestilling ( )I eksemplet ovenfor starter vi med å importere Plotly express-modulen som px. Vi lager deretter en dataramme ved å bruke lagerdataene fra Plotly.
Til slutt lager vi et fasettert områdeplott ved å bruke px.area-funksjonen. Dette skal returnere en figur som vist nedenfor:
Vi kan konvertere figuren ovenfor til en HTML-strengrepresentasjon som vist i koden nedenfor:
import plottende. dette som dette
dette. til_html ( Fig , full_html = Falsk )Å kjøre koden ovenfor bør returnere en massiv HTML-streng som vist i skjermbildet nedenfor:
Merk at HTML-dokumentet starter ved
-elementet. Hvis du vil inkludere hele HTML-filen, setter du parameteren full_html=True som vist: import plottende. dette som dette
dette. til_html ( Fig , full_html = ekte )Legg merke til at markeringen starter ved -taggen.
For å inkludere plotly.js kan vi sette parameteren som:
import plottende. dette som dette
dette. til_html ( Fig , include_plotlyjs = 'cdn' , full_html = ekte )I eksemplet ovenfor forteller vi funksjonen å inkludere plotly.js-biblioteket via en CDN-lenke.
Vi kan bekrefte dette fra utdataene nedenfor:
Den beste måten å bruke to_html-dokumentet på er ved å eksportere HTML-strengen til en HTML-fil.
Vi kan gjøre dette ved å kjøre en enkel kode som vist nedenfor:
import plottende. dette som dette
med åpen ( 'facetted.html' , 'i' ) som f:
f. skrivelinjer ( dette. til_html ( Fig , include_plotlyjs = 'cnd' , full_html = ekte ) )I dette eksemplet bruker vi filmodulen i Python til å skrive HTML-strengen som en N html-fil.
Vi kan deretter åpne HTML-dokumentet i nettleseren og se figuren som vist:
Konklusjon
Gratulerer, du har eksportert Plotly-figuren din som en HTML-streng ved hjelp av funksjonen plotly.io.to_html.