Plotly.io.to_templated

La oss dykke inn.

Funksjonssyntaks

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

Funksjonsparametrene er:

1. Fig – spesifiserer figurobjektet hvis styling du ønsker å flytte til en mal.
2. Hopp over – angir en samling av navn på egenskapene du ønsker å ekskludere når du flytter stilen til en mal. Som standard er bare tittelegenskapen inkludert. Dette forhindrer at teksten til figuren, for eksempel aksetitler, blir importert av andre figurer.

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

Eksempel

La oss illustrere hvordan vi kan bruke funksjonen to_templated() til å eksportere stilen til en spesifikk figur til en mal.

La oss starte med å lage en figur med tilpasset styling. En eksempelkode er vist nedenfor:

I dette eksemplet lager vi et spredningsplott med tilpasset tekststil som skriftfamilie, skriftfarge, skriftstørrelse osv.

Koden ovenfor skal returnere et enkelt spredningsplott som vist:

Vi kan konvertere denne figuren til en figur med en stylingmal ved å bruke to_template()-funksjonen.

Et eksempelkode er som vist:

I koden ovenfor starter vi med å importere plotly io-modulen som io. Vi lager deretter en kopi av figuren med stilen lagret i en egendefinert mal ved å bruke to_templated()-funksjonen.

Vi kan se malen ved å kjøre koden:

Dette skal returnere en ordbok med egenskaper som definerer stilen til figuren. Et eksempel på utgangsverdi er som vist:

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

Dette skal vise figuren som er lagret i malen.

Lag en figur med malen

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

Et eksempelkode er som vist:

I eksemplet ovenfor starter vi med å importere graph_objects-modulen fra Plotly. I dette tilfellet bruker vi graph_objects da vi ønsker å lage en tom figur, men bare bruke stylingen.

Ved å bruke go.Figure()-funksjonen sender vi layoutparameteren og spesifiserer målmalen ved å bruke 'template'-egenskapen.

Vi kan deretter vise den resulterende figuren ved å kalle new_fig. Dette bør returnere:

Merk at figuren ovenfor ikke inneholder data eller tekst. Det inkluderer bare stilen, for eksempel tekstfarge, skriftfamilie, skriftstørrelse osv.

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

Eksemplet ovenfor skal returnere en figur som vist:

Merk at skriftfargen, familien og størrelsen ligner på den som er satt i malen.

Lagre en navngitt mal

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

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

Konklusjon

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