Plotly.io.to_template

Plotly Io To Template



W tym artykule dowiemy się, jak przenieść stylizację figury Plotly do określonego szablonu za pomocą funkcji to_template()f. Możesz następnie użyć szablonu do stylizacji innych figur za pomocą właściwości szablonu.

Zanurzmy się.

Składnia funkcji

Funkcja udostępnia prostą składnię, która pozwala skupić się na kodzie. Składnia jest wyrażona jak poniżej:







spisek. ten . do_szablonu ( Figa , pomijać = ( 'tytuł' , 'tekst' ) )

Parametry funkcji to:



  1. Rys – określa obiekt figury, którego stylizację chcesz przenieść do szablonu.
  2. Pomiń – określa zbiór nazw właściwości, które chcesz wykluczyć przy przenoszeniu stylizacji do szablonu. Domyślnie uwzględniana jest tylko właściwość title. Zapobiega to importowaniu tekstu rysunku, takiego jak tytuły osi, przez inne rysunki.

Figura zwraca kopię figury ze stylizacją przesuniętą do szablonu. Typ zwrotu go.Figure.



Przykład

Zilustrujmy, jak możemy użyć funkcji to_template(), aby wyeksportować stylizację określonej figury do szablonu.





Zacznijmy od stworzenia sylwetki o niestandardowej stylizacji. Przykładowy kod pokazano poniżej:

import spisek. wyrazić jak px
df = piks. dane . irys ( )
Figa = piks. rozpraszać ( df , x = 'długość_sepal' , Tak = 'szerokość_sepal' , kolor = 'gatunek' ,
tytuł = „Niestandardowa stylizacja” )
Figa. update_layout (
rodzina czcionek = „Kurier Nowy, monospace” ,
kolor czcionki = 'czerwony' ,
rozmiar czcionki = 18 ,
title_font_family = 'Czcionka Times New Roman' ,
title_font_color = 'niebieski' ,
legend_title_font_color = 'Zielony'
)
Figa. aktualizacja_xaxes ( title_font_family = „Arial” )
Figa. pokazać ( )

W tym przykładzie tworzymy wykres punktowy z niestandardowym stylem tekstu, takim jak rodzina czcionek, kolor czcionki, rozmiar czcionki itp.



Powyższy kod powinien zwrócić prosty wykres punktowy, jak pokazano:

Możemy przekonwertować tę figurę na figurę z szablonem stylizacji za pomocą funkcji to_template().

Przykładowy kod jest taki, jak pokazano:

import spisek. ten jak ten

fig_template = ten. do_szablonu ( Figa )

W powyższym kodzie zaczynamy od zaimportowania modułu plotly io jako io. Następnie tworzymy kopię figury ze stylizacją zapisaną w niestandardowym szablonie za pomocą funkcji to_template().

Możemy wyświetlić szablon, uruchamiając kod:

fig_template. układ . szablon

Powinno to zwrócić słownik z właściwościami definiującymi styl figury. Przykładowa wartość wyjściowa jest następująca:

układ. Szablon ( {

'dane' : { 'bar' : [ { „błąd_x” : { 'kolor' : „#2a3f5f” } ,

„błąd_y” : { 'kolor' : „#2a3f5f” } ,

'znacznik' : { 'linia' : { 'kolor' : „#E5ECF6” , 'szerokość' : 0,5 } ,

'wzorzec' : { „tryb wypełniania” : 'narzuta' , 'rozmiar' : 10 , 'solidność' : 0,2 } } ,

---------------------------wyjście obcięte ---------- -------------------------------

Możesz wyświetlić figurę po prostu wywołując zapisany szablon jako:

fig_template

Powinno to wyświetlić figurę zapisaną w szablonie.

Utwórz figurę za pomocą szablonu

Po zapisaniu stylizacji figury w niestandardowym szablonie możemy użyć tego szablonu, aby zastosować stylizację do innej figury.

Przykładowy kod jest taki, jak pokazano:

import spisek. graph_objectsas iść
nowa_rysunek = iść. Postać ( układ = {
'szablon' : fig_template. układ . szablon
} )
nowa_rysunek

W powyższym przykładzie zaczynamy od zaimportowania modułu graph_objects z Plotly. W tym przypadku używamy graph_objects, ponieważ chcemy utworzyć pustą figurę, ale używamy tylko stylizacji.

Za pomocą funkcji go.Figure() przekazujemy parametr layout i określamy docelowy szablon za pomocą właściwości ‘template’.

Następnie możemy wyświetlić wynikową liczbę, wywołując new_fig. To powinno zwrócić:


Zauważ, że powyższy rysunek nie zawiera żadnych danych ani tekstu. Obejmuje tylko stylizację, taką jak kolor tekstu, rodzina czcionek, rozmiar czcionki itp.

Aby utworzyć wykres punktowy za pomocą tego szablonu, możemy użyć poniższego kodu:

import spisek. graph_objectsas iść
import numpyas np
N = 1000
t = np. linspace ( 0 , 10 , pięćdziesiąt )
Tak = np. bez ( t )

Figa = iść. Postać ( dane = iść. Rozpraszać ( x = t , Tak = Tak , tryb = „znaczniki” ) , układ = {
'szablon' : fig_template. układ . szablon
} )
Figa. pokazać ( )

Powyższy przykład powinien zwrócić liczbę, jak pokazano:

Zwróć uwagę, że kolor, rodzina i rozmiar czcionki są podobne do tych ustawionych w szablonie.

Zapisywanie nazwanego szablonu

Możemy zapisać niestandardowy szablon za pomocą obiektu templates, jak pokazano w poniższym kodzie:

import spisek. ten jak ten

ten. szablony [ „mój_niestandardowy_szablon” ] = fig_template. układ . szablon

Powyższy kod zapisze szablon pod nazwą „my_custom_template”. Następnie możesz użyć tej nazwy, aby określić szablon, którego chcesz użyć:

układ = {

'szablon' : „mój_niestandardowy_szablon”

}

Wniosek

W tym samouczku dowiedzieliśmy się, jak stworzyć figurę ze stylizacją zapisaną w niestandardowym szablonie. Omówiliśmy również, jak korzystać z szablonu na innych rysunkach i zapisywać szablon do późniejszego wykorzystania.