Plotly.io.to_html

Plotly Io To Html

Hypertext Markup Language tai HTML-asiakirjat ovat merkintäasiakirjoja, joiden avulla voit näyttää tietoja World Wide Webissä. Kun tarkastelet tiettyä verkkosivustoa, käytät HTML-dokumenttia.

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:

  1. Fig – viittaa kuvaobjektiin tai kuvan sanakirjaesitykseen.
  2. Config – määrittää plotly.js-määritysasetukset. Välitä määritysasetukset sanakirjana.
  3. 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.
  4. 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.
  5. include_mathjax – määrittää, tuleeko tiedosto sisältää mathjax.js-kirjaston. Hyväksytyt arvot ovat samanlaisia ​​kuin include_plotlyjs paitsi 'require'-arvo.
  6. Post_script – voit sisällyttää JavaScript-katkelmia, jotka suoritetaan juonen luomisen jälkeen.
  7. 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ä.
  8. Animation_opts – voit määrittää mukautettuja animaatioominaisuuksia sanakirjaksi. Nämä arvot välitetään sitten plotly.animate-funktiolle plotly.js:ssa.
  9. Default_width – määrittää tuloksena olevan luvun oletusleveyden pikseleinä.
  10. Default_height – määrittää kuvan oletuskorkeuden pikseleinä.
  11. Vahvista – määrittää, tuleeko luku tarkistaa ennen kuin se muunnetaan HTML-merkkijonoksi.
  12. 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.