Samakatuwid, hindi nakakagulat na maaaring kailanganin mong i-convert ang isang partikular na Plotly figure sa isang HTML string.
Sa tutorial na ito, matututunan natin kung paano gamitin ang Plotly io module para i-convert ang figure sa isang HTML string representation.
Sumisid tayo.
Plotly.io.to_html() function
Ang to_html() function mula sa io module ng Plotly ay nagbibigay-daan sa iyo na ipasa ang isang partikular na figure bilang isang parameter at i-convert ito sa isang HTML string.
Ang function syntax ay ipinahayag tulad ng ipinapakita sa ibaba:
may pakana. ito . to_html ( fig , config = wala , auto-play = totoo , include_plotlyjs = totoo , isama ang_mathjax = Mali , post_script = wala , full_html = totoo , animation_opts = wala , default_width = '100%' , default_height = '100%' , patunayan = totoo , div_id = wala )
I-explore natin ang mga parameter ng function, sa ibaba:
- Fig – tumutukoy sa figure object o sa diksyunaryo na representasyon ng figure.
- Config – tumutukoy sa mga opsyon sa pagsasaayos ng plotly.js. Ipasa ang mga pagpipilian sa pagsasaayos bilang isang diksyunaryo.
- Auto_play – tinutukoy kung ang pagkakasunud-sunod ng animation ay dapat awtomatikong mag-play sa pag-load ng pahina. Kapaki-pakinabang ang parameter na ito kung mayroon kang figure na naglalaman ng mga animated na frame.
- Include_plotlyjs – tinutukoy ng parameter na ito kung paano isinama ang plotly.js library sa HTML. Kasama sa mga tinatanggap na value sa parameter na ito ang:
- True – kasama ang plotly.js library bilang script tag sa HTML na dokumento. Papataasin nito ang laki ng file ngunit papayagan ang file na magamit sa mga offline na kapaligiran.
- ‘cdn’ – ang pagtatakda ng include_plotlyjs na parameter sa ‘cdn’ ay magdaragdag ng script tag na tumuturo sa isang malayuang link para sa plotly.js library. Gamitin ang opsyong ito kapag nasa isang network na kapaligiran o file na sensitibo sa laki ng kapaligiran.
- ‘directory’ – may kasamang script tag na tumuturo sa isang panlabas na plotly.min.js bundle na matatagpuan sa parehong direktoryo ng HTML na dokumento.
- 'require' - ang pagtatakda ng value na kailangan ay maglo-load sa plotly.js library gamit ang require.js. Tiyakin na ang require.js ay naka-install at available sa buong mundo sa system.
- ‘False’ – hindi kasama ang plotly.js library. Iwasan ang halagang ito kapag itinatakda ang full_html parameter sa True dahil ire-render nito ang buong dokumento, hindi magagamit.
- include_mathjax – tumutukoy kung ang file ay dapat isama ang mathjax.js library. Ang mga tinatanggap na value ay katulad ng include_plotlyjs maliban sa 'require' value.
- Post_script – nagbibigay-daan sa iyong isama ang mga snippet ng JavaScript na isinagawa pagkatapos ng paggawa ng plot.
- Full_html – kung totoo, ang function ay magbabalik ng string na naglalaman ng buong HTML na dokumento, simula sa tag. Kung false, ang function ay magbabalik ng HTML string na nagsisimula sa na elemento.
- Animation_opts – nagbibigay-daan sa iyong tukuyin ang mga custom na katangian ng animation bilang isang diksyunaryo. Ang mga value na ito ay ipinapasa sa plotly.animate function sa plotly.js.
- Default_width – tumutukoy sa default na lapad ng resultang figure sa pixels.
- Default_height – tumutukoy sa default na taas ng figure sa mga pixel.
- I-validate – tinutukoy kung dapat patunayan ang figure bago ma-convert sa HTML string.
- Div_id – tumutukoy ng value ng id attribute ng div tag kung saan matatagpuan ang plot.
Pagkatapos, ang function ay nagbabalik ng isang string na representasyon ng figure bilang isang string.
Halimbawa ng Paggamit
Ang sumusunod na code ay nagpapakita kung paano gamitin ang to_html function upang i-convert ang isang figure sa isang HTML string representation.
angkat may pakana. ipahayag bilang px
df = px. datos . mga stock ( na-index = totoo )
fig = px. lugar ( df , facet_col = 'kumpanya' , facet_col_wrap = dalawa )
fig. palabas ( )Sa halimbawa sa itaas, magsisimula tayo sa pamamagitan ng pag-import ng Plotly express module bilang px. Pagkatapos ay gumawa kami ng data frame gamit ang stock data mula sa Plotly.
Panghuli, gumawa kami ng facetted area plot gamit ang px.area function. Dapat itong magbalik ng figure tulad ng ipinapakita sa ibaba:
Maaari naming i-convert ang figure sa itaas sa isang representasyon ng HTML string tulad ng ipinapakita sa code sa ibaba:
angkat may pakana. ito bilang ito
ito. to_html ( fig , full_html = Mali )Ang pagpapatakbo ng code sa itaas ay dapat magbalik ng napakalaking HTML string gaya ng ipinapakita sa screenshot sa ibaba:
Tandaan na ang HTML na dokumento ay nagsisimula sa
na elemento. Kung gusto mong isama ang buong HTML file, itakda ang parameter full_html=True gaya ng ipinapakita: angkat may pakana. ito bilang ito
ito. to_html ( fig , full_html = totoo )
Pansinin na nagsisimula ang markup sa tag na .
Upang isama ang plotly.js, maaari naming itakda ang parameter bilang:
angkat may pakana. ito bilang ito
ito. to_html ( fig , include_plotlyjs = 'cdn' , full_html = totoo )Sa halimbawa sa itaas, sinasabi namin sa function na isama ang plotly.js library sa pamamagitan ng CDN link.
Maaari naming i-verify ito mula sa output sa ibaba:
Ang pinakamahusay na paraan upang gamitin ang to_html na dokumento ay sa pamamagitan ng pag-export ng HTML string sa isang HTML file.
Magagawa natin ito sa pamamagitan ng pagpapatakbo ng isang simpleng code tulad ng ipinapakita sa ibaba:
angkat may pakana. ito bilang ito
kasama bukas ( 'facetted.html' , 'sa' ) bilang f:
f. mga writeline ( ito. to_html ( fig , include_plotlyjs = 'cnd' , full_html = totoo ) )Sa halimbawang ito, ginagamit namin ang file module sa Python para isulat ang HTML string bilang isang html file.
Pagkatapos ay maaari naming buksan ang HTML na dokumento sa browser at tingnan ang figure tulad ng ipinapakita:
Konklusyon
Binabati kita, matagumpay mong na-export ang iyong Plotly figure bilang isang HTML string gamit ang plotly.io.to_html function.