Plotly.io.to_templated

Plotly Io To Templated



V tomto článku se naučíme, jak přesunout styling obrázku Plotly do konkrétní šablony pomocí funkce to_templated()f. Šablonu pak můžete použít ke stylování dalších obrázků pomocí vlastnosti template.

Pojďme se ponořit.

Syntaxe funkce

Funkce poskytuje jednoduchou syntaxi, která vám umožní soustředit se na kód. Syntaxe je vyjádřena následovně:







dějově. tento . to_templated ( Obr , přeskočit = ( 'titul' , 'text' ) )

Parametry funkce jsou:



  1. Fig – určuje objekt obrázku, jehož styl chcete přesunout do šablony.
  2. Přeskočit – určuje kolekci názvů vlastností, které chcete vyloučit při přesouvání stylingu do šablony. Ve výchozím nastavení je zahrnuta pouze vlastnost title. To zabrání tomu, aby byl text obrázku, jako jsou názvy os, importován jinými obrázky.

Figura vrátí kopii figury se stylizací přesunutou do šablony. Typ návratu. Obrázek.



Příklad

Ukažme si, jak můžeme pomocí funkce to_templated() exportovat styl konkrétního obrázku do šablony.





Začněme vytvořením postavy s vlastním stylem. Příklad kódu je uveden níže:

import dějově. vyjádřit tak jako px
df = px. data . duhovka ( )
Obr = px. rozptyl ( df , X = 'sepal_length' , Y = 'sepal_width' , barva = 'druh' ,
titul = 'Vlastní styl' )
Obr. update_layout (
font_family = 'Courier New, monospace' ,
barva fontu = 'Červené' ,
velikost písma = 18 ,
title_font_family = 'Times New Roman' ,
název_barva_písma = 'modrý' ,
legenda_title_font_color = 'zelená'
)
Obr. update_xaxes ( title_font_family = 'Arial' )
Obr. ukázat ( )

V tomto příkladu vytvoříme bodový graf s vlastním stylem textu, jako je rodina písem, barva písma, velikost písma atd.



Výše uvedený kód by měl vrátit jednoduchý bodový graf, jak je znázorněno:

Tento obrázek můžeme převést na obrázek pomocí šablony stylingu pomocí funkce to_template().

Příklad kódu je uveden:

import dějově. tento tak jako tento

fig_templated = tento. to_templated ( Obr )

Ve výše uvedeném kódu začneme importem modulu plotly io jako io. Poté vytvoříme kopii obrázku se stylizací uloženou do vlastní šablony pomocí funkce to_templated().

Šablonu můžeme zobrazit spuštěním kódu:

fig_templated. rozložení . šablona

To by mělo vrátit slovník s vlastnostmi, které definují styl obrázku. Příklad výstupní hodnoty je následující:

rozložení. Šablona ( {

'data' : { 'bar' : [ { 'error_x' : { 'barva' : '#2a3f5f' } ,

'error_y' : { 'barva' : '#2a3f5f' } ,

'popisovač' : { 'čára' : { 'barva' : '#E5ECF6' , 'šířka' : 0,5 } ,

'vzor' : { 'fillmode' : 'overlay' , 'velikost' : 10 , 'pevnost' : 0,2 } } ,

--------------------------------------výstup zkrácen----------- -------------------------------

Obrázek můžete zobrazit jednoduše voláním uložené šablony jako:

fig_templated

To by mělo zobrazit obrázek uložený v šabloně.

Vytvořte obrázek pomocí šablony

Jakmile uložíme styl figury do vlastní šablony, můžeme tuto šablonu použít k aplikaci stylu na jinou figuru.

Příklad kódu je uveden:

import dějově. graph_objectsas jít
nový_obr = jít. Postava ( rozložení = {
'šablona' : fig_templated. rozložení . šablona
} )
nový_obr

Ve výše uvedeném příkladu začneme importem modulu graph_objects z Plotly. V tomto případě používáme graph_objects, protože chceme vytvořit prázdný obrázek, ale použijeme pouze styl.

Pomocí funkce go.Figure() předáme parametr layout a pomocí vlastnosti ‚template‘ určíme cílovou šablonu.

Výsledný obrázek pak můžeme zobrazit voláním new_fig. Toto by se mělo vrátit:


Všimněte si, že výše uvedený obrázek neobsahuje žádná data ani text. Zahrnuje pouze styl, jako je barva textu, rodina písem, velikost písma atd.

Chcete-li vytvořit bodový graf s touto šablonou, můžeme použít kód, jak je znázorněno:

import dějově. graph_objectsas jít
import numpyas np
N = 1000
t = např. linspace ( 0 , 10 , padesáti )
Y = např. bez ( t )

Obr = jít. Postava ( data = jít. Rozptyl ( X = t , Y = Y , režimu = 'markery' ) , rozložení = {
'šablona' : fig_templated. rozložení . šablona
} )
Obr. ukázat ( )

Výše uvedený příklad by měl vrátit obrázek, jak je znázorněno:

Všimněte si, že barva, rodina a velikost písma jsou podobné těm, které jsou nastaveny v šabloně.

Uložení pojmenované šablony

Vlastní šablonu můžeme uložit pomocí objektu šablon, jak je znázorněno v kódu níže:

import dějově. tento tak jako tento

tento. šablony [ 'my_custom_template' ] = fig_templated. rozložení . šablona

Výše uvedený kód uloží šablonu pod názvem ‚my_custom_template‘. Tento název pak můžete použít k určení šablony, kterou chcete použít:

rozložení = {

'šablona' : 'my_custom_template'

}

Závěr

V tomto tutoriálu jsme se naučili, jak vytvořit postavu se stylem uloženým do vlastní šablony. Také jsme se zabývali tím, jak použít šablonu na jiných obrázcích a uložit šablonu pro pozdější použití.