Plotly.io.to_templated

Lad os dykke ned.

Funktions syntaks

Funktionen giver en simpel syntaks, der giver dig mulighed for at fokusere på koden. Syntaksen er udtrykt som nedenfor:

Funktionsparametrene er:

1. Fig – angiver det figurobjekt, hvis styling du ønsker at flytte til en skabelon.
2. Spring over – angiver en samling af navne på de egenskaber, du ønsker at ekskludere, når du flytter stylingen til en skabelon. Som standard er kun titelegenskaben inkluderet. Dette forhindrer figurens tekst, såsom aksetitler, i at blive importeret af andre figurer.

Figuren returnerer en kopi af figuren med stylingen flyttet til en skabelon. Returtypen af ​​go.Figur.

Eksempel

Lad os illustrere, hvordan vi kan bruge funktionen to_templated() til at eksportere stylingen af ​​en specifik figur til en skabelon.

Lad os starte med at skabe en figur med tilpasset styling. Et eksempel på kode er vist nedenfor:

I dette eksempel opretter vi et scatterplot med tilpasset tekststil, såsom skrifttypefamilie, skriftfarve, skriftstørrelse osv.

Ovenstående kode skal returnere et simpelt scatterplot som vist:

Vi kan konvertere denne figur til en figur med en stilskabelon ved hjælp af to_template()-funktionen.

Et eksempelkode er som vist:

I koden ovenfor starter vi med at importere plotly io-modulet som io. Vi opretter derefter en kopi af figuren med stylingen gemt i en brugerdefineret skabelon ved hjælp af to_templated()-funktionen.

Vi kan se skabelonen ved at køre koden:

Dette skulle returnere en ordbog med egenskaber, der definerer figurens stil. Et eksempel på outputværdi er som vist:

Du kan blot vise figuren ved at kalde den gemte skabelon som:

Dette skulle vise den figur, der er gemt i skabelonen.

Opret en figur med skabelonen

Når vi har gemt stylingen af ​​en figur til en brugerdefineret skabelon, kan vi bruge den skabelon til at anvende stylingen på en anden figur.

Et eksempelkode er som vist:

I eksemplet ovenfor starter vi med at importere graph_objects-modulet fra Plotly. I dette tilfælde bruger vi graph_objects, da vi ønsker at skabe en tom figur, men kun bruge stylingen.

Ved at bruge funktionen go.Figure() sender vi layoutparameteren og angiver målskabelonen ved hjælp af egenskaben 'skabelon'.

Vi kan derefter vise den resulterende figur ved at kalde new_fig. Dette skulle returnere:

Bemærk, at figuren ovenfor ikke indeholder data eller tekst. Det inkluderer kun stylingen, såsom tekstfarve, skrifttypefamilie, skriftstørrelse osv.

For at oprette et scatter plot med denne skabelon kan vi bruge koden som vist:

Eksemplet ovenfor skulle returnere en figur som vist:

Bemærk, at skrifttypefarven, -familien og -størrelsen svarer til den, der er angivet i skabelonen.

Gem en navngivet skabelon

Vi kan gemme den brugerdefinerede skabelon ved hjælp af skabelonobjektet som vist i koden nedenfor:

Ovenstående kode gemmer skabelonen under navnet 'my_custom_template'. Du kan derefter bruge dette navn til at angive den skabelon, du ønsker at bruge:

Konklusion

I denne tutorial lærte vi, hvordan man opretter en figur med stylingen gemt i en brugerdefineret skabelon. Vi dækkede også, hvordan man bruger skabelonen i andre figurer og gemmer skabelonen til senere brug.