Plotly.io.to_html

Plotly Io To Html



Hypertext Markup Language nebo HTML dokumenty jsou značkovací dokumenty, které umožňují zobrazovat informace na World Wide Web. Když si prohlížíte konkrétní web, používáte dokument HTML.

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:

  1. Obr – odkazuje na objekt obrázku nebo slovníkovou reprezentaci obrázku.
  2. Config – určuje možnosti konfigurace plotly.js. Předejte možnosti konfigurace jako slovník.
  3. 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.
  4. 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ý.
  5. 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“.
  6. Post_script – umožňuje zahrnout úryvky JavaScriptu, které se spouštějí po vytvoření grafu.
  7. 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
    .
  8. Animation_opts – umožňuje zadat vlastní vlastnosti animace jako slovník. Tyto hodnoty jsou poté předány funkci plotly.animate v plotly.js.
  9. Default_width – určuje výchozí šířku výsledného obrázku v pixelech.
  10. Default_height – určuje výchozí výšku postavy v pixelech.
  11. Ověřit – určuje, zda má být obrázek před převedením na řetězec HTML ověřen.
  12. 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.