Het is daarom geen verrassing dat u een specifiek Plotly-figuur moet converteren naar een HTML-string.
In deze zelfstudie leren we hoe we de Plotly io-module kunnen gebruiken om een figuur om te zetten in een HTML-tekenreeksrepresentatie.
Laten we erin duiken.
Plotly.io.to_html() functie
Met de functie to_html() uit de io-module van Plotly kun je een specifiek cijfer als parameter doorgeven en omzetten in een HTML-tekenreeks.
De syntaxis van de functie wordt uitgedrukt zoals hieronder weergegeven:
complot. deze . naar_html ( vijg , configuratie = Geen , automatisch afspelen = WAAR , include_plotlyjs = WAAR , include_mathjax = niet waar , post_script = Geen , full_html = WAAR , animatie_opts = Geen , default_width = '100%' , default_height = '100%' , valideren = WAAR , div_id = Geen )
Laten we de functieparameters hieronder verkennen:
- Fig – verwijst naar het figuurobject of de woordenboekrepresentatie van de figuur.
- Config – specificeert de plotly.js configuratie-opties. Geef de configuratie-opties door als een woordenboek.
- Auto_play – bepaalt of de animatiereeks automatisch moet worden afgespeeld bij het laden van de pagina. Deze parameter is handig als je een figuur hebt met geanimeerde frames.
- Include_plotlyjs – deze parameter specificeert hoe de plotly.js-bibliotheek wordt opgenomen in de HTML. Geaccepteerde waarden in deze parameter zijn onder meer:
- True - bevat de plotly.js-bibliotheek als een scripttag in het HTML-document. Hierdoor wordt de bestandsgrootte groter, maar kan het bestand in offline omgevingen worden gebruikt.
- 'cdn' - als u de parameter include_plotlyjs instelt op 'cdn', wordt een scripttag toegevoegd die verwijst naar een externe link voor de plotly.js-bibliotheek. Gebruik deze optie in een netwerkomgeving of in een omgeving die gevoelig is voor bestandsgrootte.
- 'directory' - bevat een scripttag die verwijst naar een externe plotly.min.js-bundel die zich in dezelfde map als het HTML-document bevindt.
- 'require' - door de waarde in te stellen die vereist is, wordt de plotly.js-bibliotheek geladen met behulp van required.js. Zorg ervoor dat required.js is geïnstalleerd en wereldwijd beschikbaar is op het systeem.
- 'False' - omvat niet de plotly.js-bibliotheek. Vermijd deze waarde bij het instellen van de parameter full_html op True, omdat het hele document hierdoor onbruikbaar wordt.
- include_mathjax – specificeert of het bestand de mathjax.js-bibliotheek moet bevatten. Geaccepteerde waarden zijn vergelijkbaar met include_plotlyjs, behalve de 'require'-waarde.
- Post_script – hiermee kunt u JavaScript-fragmenten opnemen die worden uitgevoerd na het maken van de plot.
- Full_html – indien waar, retourneert de functie een tekenreeks die het volledige HTML-document bevat, te beginnen met de -tags. Indien onwaar, retourneert de functie een HTML-tekenreeks die begint met het -element.
- Animation_opts – hiermee kunt u aangepaste animatie-eigenschappen specificeren als een woordenboek. Deze waarden worden vervolgens doorgegeven aan de functie plotly.animate in plotly.js.
- Default_width – specificeert de standaardbreedte van de resulterende figuur in pixels.
- Default_height – specificeert de standaardhoogte van de figuur in pixels.
- Valideren – bepaalt of het cijfer moet worden gevalideerd voordat het wordt geconverteerd naar een HTML-tekenreeks.
- Div_id – specificeert een waarde van het id-attribuut van de div-tag waar de plot zich bevindt.
Vervolgens retourneert de functie een tekenreeksrepresentatie van de figuur als een tekenreeks.
Voorbeeldgebruik:
De volgende code laat zien hoe u de functie to_html kunt gebruiken om een figuur om te zetten in een HTML-tekenreeksrepresentatie.
importeren complot. uitdrukken net zo px
df = px. gegevens . aandelen ( geïndexeerd = WAAR )
vijg = px. Oppervlakte ( df , facet_col = 'bedrijf' , facet_col_wrap = twee )
afb. show ( )In het bovenstaande voorbeeld beginnen we met het importeren van de Plotly express-module als px. Vervolgens maken we een dataframe met behulp van de voorraadgegevens van Plotly.
Ten slotte maken we een gefacetteerde gebiedsplot met behulp van de px.area-functie. Dit zou een figuur moeten retourneren zoals hieronder weergegeven:
We kunnen de bovenstaande afbeelding omzetten in een HTML-tekenreeksrepresentatie zoals weergegeven in de onderstaande code:
importeren complot. deze net zo deze
deze. naar_html ( vijg , full_html = niet waar )Het uitvoeren van de bovenstaande code zou een enorme HTML-tekenreeks moeten retourneren, zoals weergegeven in de onderstaande schermafbeelding:
Merk op dat het HTML-document begint bij het
-element. Als u het volledige HTML-bestand wilt opnemen, stelt u de parameter full_html=True in zoals weergegeven: importeren complot. deze net zo deze
deze. naar_html ( vijg , full_html = WAAR )
Merk op dat de opmaak begint bij de -tag.
Om plotly.js op te nemen, kunnen we de parameter instellen als:
importeren complot. deze net zo deze
deze. naar_html ( vijg , include_plotlyjs = 'cdn' , full_html = WAAR )In het bovenstaande voorbeeld vertellen we de functie om de plotly.js-bibliotheek op te nemen via een CDN-link.
We kunnen dit verifiëren aan de hand van de onderstaande output:
De beste manier om het to_html-document te gebruiken, is door de HTML-string naar een HTML-bestand te exporteren.
We kunnen dit doen door een eenvoudige code uit te voeren, zoals hieronder wordt weergegeven:
importeren complot. deze net zo deze
met open ( 'facetten.html' , 'in' ) net zo f:
f. schrijflijnen ( deze. naar_html ( vijg , include_plotlyjs = 'cnd' , full_html = WAAR ) )In dit voorbeeld gebruiken we de bestandsmodule in Python om de HTML-string als een N html-bestand te schrijven.
We kunnen dan het HTML-document in de browser openen en de afbeelding bekijken zoals weergegeven:
Conclusie
Gefeliciteerd, je hebt je Plotly-figuur succesvol geëxporteerd als een HTML-string met behulp van de functie plotly.io.to_html.