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:
- Fig – odkazuje na objekt obrázku alebo slovníkovú reprezentáciu obrázku.
- Config – určuje možnosti konfigurácie plotly.js. Odovzdajte možnosti konfigurácie ako slovník.
- 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.
- 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ý.
- include_mathjax – určuje, či má súbor obsahovať knižnicu mathjax.js. Akceptované hodnoty sú podobné ako include_plotlyjs okrem hodnoty „require“.
- Post_script – umožňuje zahrnúť úryvky JavaScriptu, ktoré sa spustia po vytvorení grafu.
- 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 .
- 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.
- Default_width – určuje predvolenú šírku výsledného čísla v pixeloch.
- Default_height – určuje predvolenú výšku postavy v pixeloch.
- Validate – určuje, či má byť obrázok overený pred konverziou na HTML reťazec.
- 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.