Det er derfor ingen overraskelse, at du muligvis skal konvertere en specifik Plotly-figur til en HTML-streng.
I denne vejledning lærer vi, hvordan du bruger Plotly io-modulet til at konvertere en figur til en HTML-strengrepræsentation.
Lad os dykke ned.
Plotly.io.to_html() funktion
Funktionen to_html() fra Plotlys io-modul giver dig mulighed for at sende en specifik figur som en parameter og konvertere den til en HTML-streng.
Funktionens syntaks er udtrykt som vist nedenfor:
plottet. dette . to_html ( fig , config = Ingen , automatisk afspilning = Rigtigt , include_plotlyjs = Rigtigt , include_mathjax = Falsk , post_script = Ingen , fuld_html = Rigtigt , animation_opts = Ingen , default_width = '100%' , standard_højde = '100%' , validere = Rigtigt , div_id = Ingen )
Lad os udforske funktionsparametrene nedenfor:
- Fig – henviser til figurobjektet eller ordbogsrepræsentationen af figuren.
- Config – angiver plotly.js-konfigurationsmulighederne. Send konfigurationsmulighederne som en ordbog.
- Auto_play – bestemmer, om animationssekvensen skal afspilles automatisk ved sideindlæsningen. Denne parameter er nyttig, hvis du har en figur, der indeholder animerede rammer.
- Include_plotlyjs – denne parameter specificerer, hvordan plotly.js-biblioteket er inkluderet i HTML. Accepterede værdier i denne parameter inkluderer:
- Sand – inkluderer plotly.js-biblioteket som et script-tag i HTML-dokumentet. Dette vil øge filstørrelsen, men vil tillade, at filen bruges i offline miljøer.
- 'cdn' – indstilling af include_plotlyjs-parameteren til 'cdn' vil tilføje et script-tag, der peger på et fjernlink til plotly.js-biblioteket. Brug denne indstilling, når du er i et netværksmiljø eller filstørrelsesfølsomt miljø.
- 'directory' – inkluderer et script-tag, der peger på en ekstern plotly.min.js-bundt placeret i samme mappe som HTML-dokumentet.
- ‘require’ – indstilling af værdien til require vil indlæse plotly.js-biblioteket ved hjælp af require.js. Sørg for, at require.js er installeret og tilgængeligt globalt på systemet.
- ‘False’ – inkluderer ikke plotly.js-biblioteket. Undgå denne værdi, når du indstiller parameteren full_html til True, da det vil gøre hele dokumentet ubrugeligt.
- include_mathjax – angiver, om filen skal indeholde mathjax.js-biblioteket. Accepterede værdier ligner include_plotlyjs undtagen 'require'-værdien.
- Post_script – giver dig mulighed for at inkludere JavaScript-uddrag, der udføres efter plotoprettelsen.
- Full_html – hvis sand, vil funktionen returnere en streng, der indeholder hele HTML-dokumentet, begyndende med -tags. Hvis falsk, vil funktionen returnere en HTML-streng, der starter med -elementet.
- Animation_opts – giver dig mulighed for at angive brugerdefinerede animationsegenskaber som en ordbog. Disse værdier sendes derefter til funktionen plotly.animate i plotly.js.
- Default_width – angiver standardbredden af det resulterende tal i pixels.
- Default_height – angiver standardhøjden for figuren i pixels.
- Valider – bestemmer, om figuren skal valideres, før den konverteres til en HTML-streng.
- Div_id – angiver en værdi af id-attributten for div-tagget, hvor plottet er placeret.
Derefter returnerer funktionen en strengrepræsentation af figuren som en streng.
Eksempel på brug
Den følgende kode viser, hvordan man bruger to_html-funktionen til at konvertere en figur til en HTML-strengrepræsentation.
importere plottet. udtrykke som px
df = px. data . aktier ( indekseret = Rigtigt )
fig = px. areal ( df , facet_col = 'Selskab' , facet_col_wrap = to )
fig. at vise ( )I eksemplet ovenfor starter vi med at importere Plotly express-modulet som px. Vi opretter derefter en dataramme ved hjælp af lagerdata fra Plotly.
Til sidst opretter vi et facetteret områdeplot ved hjælp af funktionen px.area. Dette skulle returnere en figur som vist nedenfor:
Vi kan konvertere ovenstående figur til en HTML-strengrepræsentation som vist i koden nedenfor:
importere plottet. dette som dette
dette. to_html ( fig , fuld_html = Falsk )Kørsel af koden ovenfor skulle returnere en massiv HTML-streng som vist på skærmbilledet nedenfor:
Bemærk, at HTML-dokumentet starter ved
-elementet. Hvis du vil inkludere hele HTML-filen, skal du indstille parameteren full_html=True som vist: importere plottet. dette som dette
dette. to_html ( fig , fuld_html = Rigtigt )
Bemærk, at markeringen starter ved -tagget.
For at inkludere plotly.js kan vi indstille parameteren som:
importere plottet. dette som dette
dette. to_html ( fig , include_plotlyjs = 'cdn' , fuld_html = Rigtigt )I eksemplet ovenfor fortæller vi funktionen at inkludere plotly.js-biblioteket via et CDN-link.
Vi kan bekræfte dette fra outputtet nedenfor:
Den bedste måde at bruge to_html-dokumentet på er ved at eksportere HTML-strengen til en HTML-fil.
Vi kan gøre dette ved at køre en simpel kode som vist nedenfor:
importere plottet. dette som dette
med åben ( 'facetteret.html' , 'i' ) som f:
f. skrivelinjer ( dette. to_html ( fig , include_plotlyjs = 'cnd' , fuld_html = Rigtigt ) )I dette eksempel bruger vi filmodulet i Python til at skrive HTML-strengen som en N html-fil.
Vi kan derefter åbne HTML-dokumentet i browseren og se figuren som vist:
Konklusion
Tillykke, du har eksporteret din Plotly-figur som en HTML-streng ved hjælp af funktionen plotly.io.to_html.