Plotly.io.to_html

Plotly Io To Html



Hypertext Markup Language alebo HTML dokumenty sú značkovacie dokumenty, ktoré vám umožňujú zobrazovať informácie na World Wide Web. Keď si prezeráte konkrétnu webovú stránku, používate dokument HTML.

Nie je preto žiadnym prekvapením, že možno budete musieť previesť konkrétnu figúrku Plotly na reťazec HTML.

V tomto návode sa naučíme, ako používať modul Plotly io na konverziu obrázku na reprezentáciu reťazca HTML.







Poďme sa ponoriť.



Funkcia Plotly.io.to_html().

Funkcia to_html() z io modulu Plotly vám umožňuje odovzdať konkrétny údaj ako parameter a previesť ho na reťazec HTML.



Syntax funkcie je vyjadrená takto:





zápletka. toto . do_html ( obr , config = žiadne , auto_play = Pravda , include_plotlyjs = Pravda , include_mathjax = Nepravdivé , post_script = žiadne , full_html = Pravda , animation_opts = žiadne , default_width = '100 %' , default_height = '100 %' , potvrdiť = Pravda , div_id = žiadne )

Pozrime sa na parametre funkcie nižšie:

  1. Fig – odkazuje na objekt obrázku alebo slovníkovú reprezentáciu obrázku.
  2. Config – určuje možnosti konfigurácie plotly.js. Odovzdajte možnosti konfigurácie ako slovník.
  3. Auto_play – určuje, či sa má sekvencia animácie prehrať automaticky pri načítaní stránky. Tento parameter je užitočný, ak máte figúrku obsahujúcu animované snímky.
  4. Include_plotlyjs – tento parameter určuje, ako je knižnica plotly.js zahrnutá do HTML. Akceptované hodnoty v tomto parametri zahŕňajú:
    • True – zahŕňa knižnicu plotly.js ako značku skriptu v dokumente HTML. Tým sa zväčší veľkosť súboru, ale umožní sa použitie súboru v offline prostrediach.
    • „cdn“ – nastavením parametra include_plotlyjs na hodnotu „cdn“ sa pridá značka skriptu smerujúca na vzdialený odkaz na knižnicu plotly.js. Túto možnosť použite v sieťovom prostredí alebo v prostredí citlivom na veľkosť súboru.
    • „adresár“ – obsahuje značku skriptu, ktorá ukazuje na externý balík plotly.min.js umiestnený v rovnakom adresári ako dokument HTML.
    • ‘require’ – nastavením hodnoty na required sa načíta knižnica plotly.js pomocou require.js. Uistite sa, že súbor require.js je nainštalovaný a globálne dostupný v systéme.
    • „False“ – nezahŕňa knižnicu plotly.js. Vyhnite sa tejto hodnote pri nastavovaní parametra full_html na hodnotu True, pretože celý dokument bude nepoužiteľný.
  5. include_mathjax – určuje, či má súbor obsahovať knižnicu mathjax.js. Akceptované hodnoty sú podobné ako include_plotlyjs okrem hodnoty „require“.
  6. Post_script – umožňuje zahrnúť úryvky JavaScriptu, ktoré sa spustia po vytvorení grafu.
  7. Full_html – ak je true, funkcia vráti reťazec obsahujúci celý HTML dokument, počnúc značkami . Ak je hodnota false, funkcia vráti reťazec HTML začínajúci prvkom
    .
  8. Animation_opts – umožňuje zadať vlastné vlastnosti animácie ako slovník. Tieto hodnoty sa potom odovzdajú funkcii plotly.animate v súbore plotly.js.
  9. Default_width – určuje predvolenú šírku výsledného čísla v pixeloch.
  10. Default_height – určuje predvolenú výšku postavy v pixeloch.
  11. Validate – určuje, či má byť obrázok overený pred konverziou na HTML reťazec.
  12. Div_id – určuje hodnotu atribútu id tagu div, kde sa graf nachádza.

Potom funkcia vráti reťazcovú reprezentáciu obrázku ako reťazec.



Príklad použitia

Nasledujúci kód ukazuje, ako použiť funkciu to_html na konverziu obrázku na reprezentáciu reťazca HTML.

importovať zápletka. expresné ako px

df = px. údajov . zásob ( indexované = Pravda )

obr = px. oblasť ( df , facet_col = 'spoločnosť' , facet_col_wrap = dva )

obr. šou ( )

Vo vyššie uvedenom príklade začneme importovaním expresného modulu Plotly ako px. Potom vytvoríme dátový rámec pomocou údajov o sklade z Plotly.

Nakoniec pomocou funkcie px.area vytvoríme fazetový plošný graf. Toto by malo vrátiť číslo, ako je uvedené nižšie:

Vyššie uvedený obrázok môžeme previesť na reprezentáciu reťazca HTML, ako je znázornené v kóde nižšie:

importovať zápletka. toto ako toto

toto. do_html ( obr , full_html = Nepravdivé )

Spustenie vyššie uvedeného kódu by malo vrátiť masívny reťazec HTML, ako je znázornené na obrázku nižšie:

Všimnite si, že HTML dokument začína elementom

. Ak chcete zahrnúť celý súbor HTML, nastavte parameter full_html=True, ako je znázornené:

importovať zápletka. toto ako toto

toto. do_html ( obr , full_html = Pravda )

Všimnite si, že označenie začína značkou .

Ak chcete zahrnúť plotly.js, môžeme nastaviť parameter ako:

importovať zápletka. toto ako toto

toto. do_html ( obr , include_plotlyjs = 'cdn' , full_html = Pravda )

Vo vyššie uvedenom príklade povieme funkcii, aby zahrnula knižnicu plotly.js prostredníctvom odkazu CDN.

Môžeme si to overiť z výstupu nižšie:

Najlepší spôsob, ako použiť dokument to_html, je exportovať reťazec HTML do súboru HTML.

Môžeme to urobiť spustením jednoduchého kódu, ako je uvedené nižšie:

importovať zápletka. toto ako toto

s OTVORENÉ ( 'facetted.html' , 'in' ) ako f:

f. writelines ( toto. do_html ( obr , include_plotlyjs = 'cnd' , full_html = Pravda ) )

V tomto príklade používame súborový modul v Pythone na zápis reťazca HTML ako súboru html.

Potom môžeme otvoriť HTML dokument v prehliadači a zobraziť obrázok, ako je znázornené:

Záver

Gratulujeme, úspešne ste exportovali svoju figúrku Plotly ako reťazec HTML pomocou funkcie plotly.io.to_html.