Není proto překvapením, že možná budete muset převést konkrétní obrázek Plotly na řetězec HTML.
V tomto tutoriálu se naučíme, jak používat modul Plotly io k převodu obrázku na reprezentaci řetězce HTML.
Pojďme se ponořit.
Funkce Plotly.io.to_html().
Funkce to_html() z io modulu Plotly vám umožňuje předat konkrétní číslo jako parametr a převést jej na řetězec HTML.
Syntaxe funkce je vyjádřena následovně:
dějově. tento . do_html ( Obr , config = Žádný , automatické přehrávání = Skutečný , include_plotlyjs = Skutečný , include_mathjax = Nepravdivé , post_script = Žádný , full_html = Skutečný , možnosti animace = Žádný , výchozí_šířka = '100%' , výchozí_výška = '100%' , ověřit = Skutečný , div_id = Žádný )
Podívejme se na parametry funkcí níže:
- Obr – odkazuje na objekt obrázku nebo slovníkovou reprezentaci obrázku.
- Config – určuje možnosti konfigurace plotly.js. Předejte možnosti konfigurace jako slovník.
- Auto_play – určuje, zda se má sekvence animace přehrát automaticky při načtení stránky. Tento parametr je užitečný, pokud máte obrázek obsahující animované snímky.
- Include_plotlyjs – tento parametr určuje, jak je knihovna plotly.js zahrnuta do HTML. Akceptované hodnoty v tomto parametru zahrnují:
- True – zahrnuje knihovnu plotly.js jako značku skriptu v dokumentu HTML. Tím se zvětší velikost souboru, ale umožní to použití souboru v offline prostředí.
- ‚cdn‘ – nastavením parametru include_plotlyjs na ‚cdn‘ přidáte značku skriptu ukazující na vzdálený odkaz na knihovnu plotly.js. Tuto možnost použijte v síťovém prostředí nebo v prostředí citlivém na velikost souboru.
- ‘adresář’ – obsahuje značku skriptu, která ukazuje na externí balíček plotly.min.js umístěný ve stejném adresáři jako dokument HTML.
- ‘require’ – nastavením hodnoty na required načte knihovnu plotly.js pomocí require.js. Zajistěte, aby byl soubor require.js nainstalován a v systému dostupný globálně.
- ‘False’ – nezahrnuje knihovnu plotly.js. Vyhněte se této hodnotě při nastavování parametru full_html na hodnotu True, protože celý dokument bude nepoužitelný.
- include_mathjax – určuje, zda má soubor obsahovat knihovnu mathjax.js. Přijímané hodnoty jsou podobné jako include_plotlyjs s výjimkou hodnoty „vyžadovat“.
- Post_script – umožňuje zahrnout úryvky JavaScriptu, které se spouštějí po vytvoření grafu.
- Full_html – pokud je true, funkce vrátí řetězec obsahující celý HTML dokument, počínaje značkami . Pokud je false, funkce vrátí řetězec HTML začínající prvkem .
- Animation_opts – umožňuje zadat vlastní vlastnosti animace jako slovník. Tyto hodnoty jsou poté předány funkci plotly.animate v plotly.js.
- Default_width – určuje výchozí šířku výsledného obrázku v pixelech.
- Default_height – určuje výchozí výšku postavy v pixelech.
- Ověřit – určuje, zda má být obrázek před převedením na řetězec HTML ověřen.
- Div_id – určuje hodnotu atributu id tagu div, kde se graf nachází.
Poté funkce vrátí řetězcovou reprezentaci obrázku jako řetězec.
Příklad použití
Následující kód ukazuje, jak použít funkci to_html k převodu obrázku na reprezentaci řetězce HTML.
import dějově. vyjádřit tak jako px
df = px. data . zásoby ( indexováno = Skutečný )
Obr = px. plocha ( df , facet_col = 'společnost' , facet_col_wrap = dva )
Obr. ukázat ( )Ve výše uvedeném příkladu začneme importem expresního modulu Plotly jako px. Poté vytvoříme datový rámec pomocí skladových dat z Plotly.
Nakonec pomocí funkce px.area vytvoříme fasetovaný plošný výkres. To by mělo vrátit číslo, jak je uvedeno níže:
Výše uvedený obrázek můžeme převést na reprezentaci řetězce HTML, jak je znázorněno v kódu níže:
import dějově. tento tak jako tento
tento. do_html ( Obr , full_html = Nepravdivé )Spuštění výše uvedeného kódu by mělo vrátit masivní řetězec HTML, jak je znázorněno na obrázku níže:
Všimněte si, že HTML dokument začíná elementem
. Pokud chcete zahrnout celý soubor HTML, nastavte parametr full_html=True, jak je znázorněno: import dějově. tento tak jako tento
tento. do_html ( Obr , full_html = Skutečný )Všimněte si, že označení začíná u značky .
Chcete-li zahrnout plotly.js, můžeme nastavit parametr takto:
import dějově. tento tak jako tento
tento. do_html ( Obr , include_plotlyjs = 'cdn' , full_html = Skutečný )Ve výše uvedeném příkladu říkáme funkci, aby zahrnula knihovnu plotly.js prostřednictvím odkazu CDN.
Můžeme to ověřit z výstupu níže:
Nejlepší způsob, jak použít dokument to_html, je exportovat řetězec HTML do souboru HTML.
Můžeme to udělat spuštěním jednoduchého kódu, jak je uvedeno níže:
import dějově. tento tak jako tento
s OTEVŘENO ( 'facetted.html' , 'v' ) tak jako F:
F. writelines ( tento. do_html ( Obr , include_plotlyjs = 'cnd' , full_html = Skutečný ) )V tomto příkladu používáme souborový modul v Pythonu k zápisu řetězce HTML jako souboru html.
Poté můžeme otevřít dokument HTML v prohlížeči a zobrazit obrázek, jak je znázorněno:
Závěr
Gratulujeme, úspěšně jste exportovali svůj obrázek Plotly jako řetězec HTML pomocí funkce plotly.io.to_html.