Ezért nem meglepő, hogy előfordulhat, hogy egy adott Plotly-figurát HTML-sztringgé kell konvertálnia.
Ebben az oktatóanyagban megtanuljuk, hogyan lehet a Plotly io modult használni egy figura HTML karakterlánc-reprezentációvá alakítására.
merüljünk bele.
Plotly.io.to_html() függvény
A Plotly io moduljának to_html() függvénye lehetővé teszi, hogy egy adott számot paraméterként adjon át, és HTML karakterláncsá alakítsa át.
A függvény szintaxisát az alábbiak szerint fejezzük ki:
cselekményesen. ez . to_html ( ábra , config = Egyik sem , automatikus lejátszás = Igaz , include_plotlyjs = Igaz , include_mathjax = Hamis , utóirat = Egyik sem , full_html = Igaz , animation_opts = Egyik sem , alapértelmezett_szélesség = '100%' , alapértelmezett_magasság = '100%' , érvényesít = Igaz , div_id = Egyik sem )
Vizsgáljuk meg a függvény paramétereit az alábbiakban:
- ábra – az ábra objektumára vagy az ábra szótári ábrázolására utal.
- Config – a plotly.js konfigurációs beállításait adja meg. Adja át a konfigurációs beállításokat szótárként.
- Auto_play – meghatározza, hogy az animációs sorozat automatikusan lejátssza-e az oldal betöltését. Ez a paraméter akkor hasznos, ha animált képkockákat tartalmazó ábrája van.
- Include_plotlyjs – ez a paraméter határozza meg, hogy a plotly.js könyvtár hogyan szerepeljen a HTML-ben. A paraméterben elfogadott értékek a következők:
- Igaz – tartalmazza a plotly.js könyvtárat szkriptcímkeként a HTML-dokumentumban. Ez növeli a fájl méretét, de lehetővé teszi a fájl offline környezetben történő használatát.
- „cdn” – ha az include_plotlyjs paramétert „cdn” értékre állítja, a program egy szkriptcímkét ad hozzá, amely a plotly.js könyvtár távoli hivatkozására mutat. Használja ezt a lehetőséget, ha hálózati környezetben vagy fájlméret-érzékeny környezetben van.
- „könyvtár” – tartalmaz egy szkriptcímkét, amely egy külső plotly.min.js kötegre mutat, amely ugyanabban a könyvtárban található, mint a HTML-dokumentum.
- „require” – az érték követelményre állítása betölti a plotly.js könyvtárat a request.js használatával. Győződjön meg arról, hogy a request.js telepítve van, és globálisan elérhető a rendszeren.
- „False” – nem tartalmazza a plotly.js könyvtárat. Kerülje el ezt az értéket, ha a full_html paramétert True értékre állítja, mivel az a teljes dokumentumot használhatatlanná teszi.
- include_mathjax – megadja, hogy a fájlnak tartalmaznia kell-e a mathjax.js könyvtárat. Az elfogadott értékek hasonlóak az include_plotlyjs értékhez, kivéve a „require” értéket.
- Post_script – lehetővé teszi JavaScript-részletek beillesztését, amelyek a telek létrehozása után futnak le.
- Full_html – ha igaz, a függvény a teljes HTML-dokumentumot tartalmazó karakterláncot ad vissza, a címkékkel kezdve. Ha hamis, a függvény a elemmel kezdődő HTML karakterláncot ad vissza.
- Animation_opts – lehetővé teszi egyéni animációs tulajdonságok megadását szótárként. Ezek az értékek ezután a plotly.js fájl plotly.animate függvényének kerülnek átadásra.
- Default_width – az eredményül kapott ábra alapértelmezett szélességét adja meg pixelben.
- Default_height – az ábra alapértelmezett magasságát adja meg pixelben.
- Érvényesítés – meghatározza, hogy az ábrát ellenőrizni kell-e, mielőtt HTML-karakterláncra konvertálnák.
- Div_id – megadja a div címke id attribútumának értékét, ahol a plot található.
Ezután a függvény az ábra karakterlánc-ábrázolását karakterláncként adja vissza.
Használati példa
A következő kód bemutatja, hogyan lehet a to_html függvényt használni egy szám HTML karakterlánc-reprezentációvá alakítására.
import cselekményesen. Expressz mint px
df = px. adat . készletek ( indexelt = Igaz )
ábra = px. terület ( df , facet_col = 'vállalat' , facet_col_wrap = két )
ábra. előadás ( )A fenti példában a Plotly expressz modult pxként importáljuk. Ezután létrehozunk egy adatkeretet a Plotly állományi adatainak felhasználásával.
Végül a px.area függvénnyel fazettált területrajzot készítünk. Ennek az alábbi ábrának kell megfelelnie:
A fenti ábrát átalakíthatjuk HTML-karakterlánc-reprezentációvá az alábbi kód szerint:
import cselekményesen. ez mint ez
ez. to_html ( ábra , full_html = Hamis )A fenti kód futtatása egy hatalmas HTML-karakterláncot ad vissza, amint az az alábbi képernyőképen látható:
Vegye figyelembe, hogy a HTML-dokumentum a
elemmel kezdődik. Ha a teljes HTML-fájlt bele akarja foglalni, állítsa be a full_html=True paramétert a képen látható módon: import cselekményesen. ez mint ez
ez. to_html ( ábra , full_html = Igaz )
Figyelje meg, hogy a jelölés a címkével kezdődik.
A plotly.js felvételéhez a paramétert a következőképpen állíthatjuk be:
import cselekményesen. ez mint ez
ez. to_html ( ábra , include_plotlyjs = 'cdn' , full_html = Igaz )A fenti példában azt mondjuk a függvénynek, hogy CDN-hivatkozáson keresztül tartalmazza a plotly.js könyvtárat.
Ezt az alábbi kimenetből ellenőrizhetjük:
A to_html dokumentum használatának legjobb módja a HTML karakterlánc HTML fájlba való exportálása.
Ezt egy egyszerű kód futtatásával tehetjük meg, az alábbiak szerint:
import cselekményesen. ez mint ez
val vel nyisd ki ( 'facetted.html' , 'ban ben' ) mint f:
f. írássorok ( ez. to_html ( ábra , include_plotlyjs = 'cnd' , full_html = Igaz ) )Ebben a példában a Python fájlmodulját használjuk a HTML karakterlánc N html fájlként írásához.
Ezután megnyithatjuk a HTML dokumentumot a böngészőben, és az ábrán látható módon megtekinthetjük:
Következtetés
Gratulálunk, sikeresen exportálta a Plotly ábrát HTML karakterláncként a plotly.io.to_html függvény segítségével.