Plotly.io.to_templated

I denne artikkelen vil vi lære å flytte stylingen av en plottfigur til en spesifikk mal ved hjelp av TO_TEMPLATED () F -funksjonen. Du kan deretter bruke malen til å style andre figurer ved hjelp av malegenskapen.

La oss dykke inn.

Funksjonssyntaks

Funksjonen gir en enkel syntaks som lar deg fokusere på koden. Syntaksen er uttrykt som nedenfor:

plotly.io.to_templated (fig, hopp = ('tittel', 'tekst'))

Funksjonsparametrene er:

1. Fig - Angir figurobjektet hvis styling du ønsker å flytte til en mal.
2. Hopp over - spesifiserer en samling av navn på egenskapene du ønsker å utelukke når du flytter stylingen til en mal. Som standard er bare tittelegenskapen inkludert. Dette forhindrer teksten til figuren, for eksempel aksetitler, fra å bli importert av andre figurer.

Figuren returnerer en kopi av figuren med stylingen flyttet til en mal. Returtypen GO.Figur.

Eksempel

La oss illustrere hvordan vi kan bruke to_templated () -funksjonen for å eksportere stylingen av en spesifikk figur til en mal.

La oss starte med å lage en figur med tilpasset styling. Et eksempelkode vises nedenfor:

Importer plotly.uttrykk som px
df = px.data.Iris ()
Fig = px.spredning (df, x = "sepal_length", y = "sepal_width", color = "art",
title = "Tilpasset styling")
Fig.update_layout (
FONT_FAMILY = "Courier New, Monospace",
font_color = "rød",
font_size = 18,
title_font_family = "Times New Roman",
title_font_color = "blå",
legend_title_font_color = "grønn"
)
Fig.update_xaxes (title_font_family = "Arial")
Fig.forestilling()

I dette eksemplet lager vi et spredt plot med tilpasset tekststyling som fontfamilie, skriftfarge, skriftstørrelse, etc.

Koden over skal returnere et enkelt spredningsplott som vist:

Vi kan konvertere denne figuren til en figur med en stylingmal ved hjelp av TO_TEMPLATE () -funksjonen.

Et eksempelkode er som vist:

Importer plotly.io som io
fig_templated = io.to_templated (fig)

I koden over starter vi med å importere den plottly IO -modulen som IO. Vi lager deretter en kopi av figuren med stylingen som er lagret til en tilpasset mal ved hjelp av to_templated () -funksjonen.

Vi kan se malen ved å kjøre koden:

Fig_templated.oppsett.mal

Dette skal returnere en ordbok med egenskaper som definerer stylingen av figuren. Et eksempel på utgangsverdien er som vist:

oppsett.Mal(
'Data': 'Bar': ['error_x': 'Color': '#2a3f5f',
'error_y': 'farge': '#2a3f5f',
'markør': 'linje': 'farge': '#e5ecf6', 'bredde': 0.5,
'Mønster': 'FillMode': 'Overlay', 'Størrelse': 10, 'Soliditet': 0.2,
--------------------------------------output avkortet-----------------------------------------

Du kan vise figuren ganske enkelt ved å ringe den lagrede malen som:

Fig_templated

Dette skal vise figuren som er lagret i malen.

Lag en figur med malen

Når vi har lagret stylingen av en figur til en tilpasset mal, kan vi bruke den malen til å bruke stylingen på en annen figur.

Et eksempelkode er som vist:

Importer plotly.Graph_Objectsas går
new_fig = gå.Figur (layout =
'mal': fig_templated.oppsett.mal
)
new_fig

I eksemplet over starter vi med å importere graf_objektmodulen fra plotly. I dette tilfellet bruker vi Graph_Objects når vi ønsker å lage en tom figur, men bruker bare stylingen.

Bruker GO.Figur () -funksjon, vi passerer layoutparameteren og spesifiserer målmalen ved å bruke egenskapen 'mal'.

Vi kan deretter vise den resulterende figuren ved å ringe new_fig. Dette skulle komme tilbake:

Merk at figuren over ikke inneholder noen data eller tekst. Det inkluderer bare styling, for eksempel tekstfarge, fontfamilie, skriftstørrelse osv.

For å lage et spredningsplott med denne malen, kan vi bruke koden som vist:

Importer plotly.Graph_Objectsas går
Importer Numpyas NP
N = 1000
t = np.Linspace (0, 10, 50)
y = np.sin (t)
Fig = GO.Figur (data = gå.Spredning (x = t, y = y, modus = 'markører'), layout =
'mal': fig_templated.oppsett.mal
)
Fig.forestilling()

Eksemplet over skal returnere en figur som vist:

Merk Fontfargen, familien og størrelsen ligner på det ene settet i malen.

Lagrer en navngitt mal

Vi kan lagre den tilpassede malen ved å bruke malobjektet som vist i koden nedenfor:

Importer plotly.io som io
io.Maler ['my_custom_template'] = fig_templated.oppsett.mal

Koden over vil lagre malen under navnet 'my_custom_template'. Du kan deretter bruke dette navnet til å spesifisere malen du ønsker å bruke:

layout =
'mal': 'my_custom_template'

Konklusjon

I denne opplæringen lærte vi hvordan vi lager en figur med stylingen lagret til en tilpasset mal. Vi dekket også hvordan du bruker malen i andre figurer og lagrer malen for senere bruk.