Siksi ei ole yllätys, että saatat joutua muuttamaan tietty Plotly-hahmo HTML-merkkijonoksi.
Tässä opetusohjelmassa opimme käyttämään Plotly io -moduulia hahmon muuntamiseen HTML-merkkijonoesitykseen.
Sukellaan sisään.
Plotly.io.to_html()-funktio
Plotlyn io-moduulin to_html()-funktion avulla voit välittää tietyn luvun parametrina ja muuntaa sen HTML-merkkijonoksi.
Toiminnon syntaksi ilmaistaan seuraavasti:
juonimainen. Tämä . to_html ( kuva , config = Ei mitään , automaattinen toisto = Totta , include_plotlyjs = Totta , include_mathjax = Väärä , post_script = Ei mitään , full_html = Totta , animation_opts = Ei mitään , oletusleveys = '100%' , oletuskorkeus = '100%' , vahvistaa = Totta , div_id = Ei mitään )
Tutkitaanpa alla olevia funktioparametreja:
- Fig – viittaa kuvaobjektiin tai kuvan sanakirjaesitykseen.
- Config – määrittää plotly.js-määritysasetukset. Välitä määritysasetukset sanakirjana.
- Auto_play – määrittää, toistetaanko animaatiosarja automaattisesti sivun latauksen yhteydessä. Tämä parametri on hyödyllinen, jos sinulla on animoituja kehyksiä sisältävä kuva.
- Include_plotlyjs – tämä parametri määrittää, kuinka plotly.js-kirjasto sisällytetään HTML-koodiin. Tämän parametrin hyväksyttyjä arvoja ovat:
- True – sisältää plotly.js-kirjaston komentosarjatunnisteena HTML-dokumenttiin. Tämä suurentaa tiedoston kokoa, mutta sallii tiedoston käytön offline-ympäristöissä.
- 'cdn' – parametrin include_plotlyjs asettaminen arvoon 'cdn' lisää komentosarjatunnisteen, joka osoittaa etälinkkiin plotly.js-kirjastoon. Käytä tätä vaihtoehtoa, kun olet verkkoympäristössä tai ympäristössä, jossa tiedostokoko on herkkä.
- 'hakemisto' – sisältää komentosarjatunnisteen, joka osoittaa ulkoiseen plotly.min.js-nippuun, joka sijaitsee samassa hakemistossa kuin HTML-dokumentti.
- 'require' – arvon asettaminen vaatimaan lataa plotly.js-kirjaston käyttämällä request.js:ää. Varmista, että request.js on asennettu ja saatavilla maailmanlaajuisesti järjestelmässä.
- 'False' – ei sisällä plotly.js-kirjastoa. Vältä tätä arvoa, kun asetat full_html-parametrin arvoksi True, koska se tekee koko asiakirjasta käyttökelvottoman.
- include_mathjax – määrittää, tuleeko tiedosto sisältää mathjax.js-kirjaston. Hyväksytyt arvot ovat samanlaisia kuin include_plotlyjs paitsi 'require'-arvo.
- Post_script – voit sisällyttää JavaScript-katkelmia, jotka suoritetaan juonen luomisen jälkeen.
- Full_html – jos tosi, funktio palauttaa merkkijonon, joka sisältää koko HTML-dokumentin, alkaen -tageista. Jos arvo on epätosi, funktio palauttaa HTML-merkkijonon, joka alkaa -elementillä.
- Animation_opts – voit määrittää mukautettuja animaatioominaisuuksia sanakirjaksi. Nämä arvot välitetään sitten plotly.animate-funktiolle plotly.js:ssa.
- Default_width – määrittää tuloksena olevan luvun oletusleveyden pikseleinä.
- Default_height – määrittää kuvan oletuskorkeuden pikseleinä.
- Vahvista – määrittää, tuleeko luku tarkistaa ennen kuin se muunnetaan HTML-merkkijonoksi.
- Div_id – määrittää id-attribuutin arvon div-tunnisteessa, jossa juoni sijaitsee.
Sitten funktio palauttaa kuvion merkkijonoesityksen merkkijonona.
Käyttöesimerkki
Seuraava koodi näyttää kuinka to_html-funktiota käytetään hahmon muuntamiseen HTML-merkkijonoesitykseen.
tuonti juonimainen. ilmaista kuten px
df = px. tiedot . osakkeet ( indeksoitu = Totta )
kuva = px. alueella ( df , faset_col = 'yhtiö' , facet_col_wrap = kaksi )
kuva näytä ( )Yllä olevassa esimerkissä aloitamme tuomalla Plotly express -moduulin nimellä px. Luomme sitten tietokehyksen käyttämällä Plotlyn varastodataa.
Lopuksi luodaan fasetoitu aluekuvaaja px.area-funktiolla. Tämän pitäisi palauttaa alla oleva luku:
Voimme muuntaa yllä olevan luvun HTML-merkkijonoesitykseen alla olevan koodin mukaisesti:
tuonti juonimainen. Tämä kuten Tämä
Tämä. to_html ( kuva , full_html = Väärä )Yllä olevan koodin suorittamisen pitäisi palauttaa massiivinen HTML-merkkijono, kuten alla olevassa kuvakaappauksessa näkyy:
Huomaa, että HTML-dokumentti alkaa
-elementistä. Jos haluat sisällyttää koko HTML-tiedoston, aseta parametriksi full_html=True kuvan mukaisesti: tuonti juonimainen. Tämä kuten Tämä
Tämä. to_html ( kuva , full_html = Totta )
Huomaa, että merkintä alkaa -tunnisteesta.
Jos haluat sisällyttää plotly.js:n, voimme asettaa parametrin seuraavasti:
tuonti juonimainen. Tämä kuten Tämä
Tämä. to_html ( kuva , include_plotlyjs = 'cdn' , full_html = Totta )Yllä olevassa esimerkissä käskemme funktiota sisällyttämään plotly.js-kirjaston CDN-linkin kautta.
Voimme varmistaa tämän alla olevasta lähdöstä:
Paras tapa käyttää to_html-asiakirjaa on viedä HTML-merkkijono HTML-tiedostoon.
Voimme tehdä tämän suorittamalla yksinkertaisen koodin alla olevan kuvan mukaisesti:
tuonti juonimainen. Tämä kuten Tämä
kanssa avata ( 'facetted.html' , 'sisään' ) kuten f:
f. kirjoitusrivit ( Tämä. to_html ( kuva , include_plotlyjs = 'cnd' , full_html = Totta ) )Tässä esimerkissä käytämme Pythonin tiedostomoduulia HTML-merkkijonon kirjoittamiseen N html-tiedostona.
Voimme sitten avata HTML-dokumentin selaimessa ja tarkastella kuvaa kuvan mukaisesti:
Johtopäätös
Onnittelut, olet onnistuneesti vienyt Plotly-hahmosi HTML-merkkijonona käyttämällä plotly.io.to_html-funktiota.