Plotly.io.to_template

Laten we erin duiken.

Functiesyntaxis

De functie biedt een eenvoudige syntaxis waarmee u zich op de code kunt concentreren. De syntaxis wordt als volgt uitgedrukt:

De functieparameters zijn:

1. Fig – specificeert het figuurobject waarvan u de stijl naar een sjabloon wilt verplaatsen.
2. Overslaan – specificeert een verzameling namen van de eigenschappen die u wilt uitsluiten bij het verplaatsen van de opmaak naar een sjabloon. Standaard wordt alleen de eigenschap title opgenomen. Dit voorkomt dat de tekst van de figuur, zoals astitels, door andere figuren wordt geïmporteerd.

De figuur retourneert een kopie van de figuur met de styling verplaatst naar een sjabloon. Het retourtype van go.Figuur.

Voorbeeld

Laten we illustreren hoe we de functie to_template() kunnen gebruiken om de stijl van een specifieke figuur naar een sjabloon te exporteren.

Laten we beginnen met het maken van een figuur met aangepaste styling. Een voorbeeldcode wordt hieronder getoond:

In dit voorbeeld maken we een spreidingsplot met aangepaste tekststijlen zoals lettertypefamilie, letterkleur, lettergrootte, enz.

De bovenstaande code zou een eenvoudig spreidingsdiagram moeten retourneren, zoals weergegeven:

We kunnen deze figuur omzetten in een figuur met een stijlsjabloon met behulp van de functie to_template().

Een voorbeeldcode ziet er als volgt uit:

In de bovenstaande code beginnen we met het importeren van de plotly io-module als io. Vervolgens maken we een kopie van de afbeelding met de styling opgeslagen in een aangepaste sjabloon met behulp van de functie to_template().

We kunnen de sjabloon bekijken door de code uit te voeren:

Dit zou een woordenboek moeten opleveren met eigenschappen die de stijl van de figuur definiëren. Een voorbeeld van een uitvoerwaarde is zoals weergegeven:

U kunt de afbeelding eenvoudig weergeven door de opgeslagen sjabloon aan te roepen als:

Dit zou het cijfer moeten weergeven dat in de sjabloon is opgeslagen.

Maak een figuur met de sjabloon

Zodra we de stijl van een figuur hebben opgeslagen in een aangepaste sjabloon, kunnen we die sjabloon gebruiken om de stijl toe te passen op een andere figuur.

Een voorbeeldcode ziet er als volgt uit:

In het bovenstaande voorbeeld beginnen we met het importeren van de module graph_objects uit Plotly. In dit geval gebruiken we graph_objects omdat we een lege figuur willen maken, maar alleen de styling gebruiken.

Met behulp van de functie go.Figuur() geven we de layout-parameter door en specificeren we de doelsjabloon met behulp van de eigenschap 'template'.

We kunnen dan het resulterende cijfer weergeven door new_fig. Dit zou moeten terugkeren:

Merk op dat de bovenstaande afbeelding geen gegevens of tekst bevat. Het bevat alleen de styling, zoals tekstkleur, lettertypefamilie, lettergrootte, enz.

Om een ​​spreidingsplot met deze sjabloon te maken, kunnen we de code gebruiken zoals weergegeven:

Het bovenstaande voorbeeld zou een figuur moeten retourneren zoals weergegeven:

Merk op dat de letterkleur, -familie en -grootte vergelijkbaar zijn met die in de sjabloon.

Een benoemde sjabloon opslaan

We kunnen de aangepaste sjabloon opslaan met behulp van het templates-object zoals weergegeven in de onderstaande code:

De bovenstaande code slaat de sjabloon op onder de naam 'my_custom_template'. U kunt deze naam vervolgens gebruiken om de sjabloon aan te geven die u wilt gebruiken:

Conclusie

In deze zelfstudie hebben we geleerd hoe u een figuur kunt maken met de stijl die is opgeslagen in een aangepaste sjabloon. We hebben ook besproken hoe u de sjabloon in andere afbeeldingen kunt gebruiken en hoe u de sjabloon kunt opslaan voor later gebruik.