Plotly.io.to_templated

Tauchen wir ein.

Funktionssyntax

Die Funktion bietet eine einfache Syntax, mit der Sie sich auf den Code konzentrieren können. Die Syntax wird wie folgt ausgedrückt:

Die Funktionsparameter sind:

1. Fig – gibt das Figurobjekt an, dessen Stil Sie in eine Vorlage verschieben möchten.
2. Überspringen – gibt eine Sammlung von Namen der Eigenschaften an, die Sie beim Verschieben des Stils in eine Vorlage ausschließen möchten. Standardmäßig ist nur die Titeleigenschaft enthalten. Dadurch wird verhindert, dass der Text der Abbildung, z. B. Achsentitel, von anderen Abbildungen importiert wird.

Die Figur gibt eine Kopie der Figur zurück, wobei der Stil in eine Vorlage verschoben wurde. Der Rückgabetyp von go.Figure.

Beispiel

Lassen Sie uns veranschaulichen, wie wir die Funktion to_templated() verwenden können, um das Styling einer bestimmten Figur in eine Vorlage zu exportieren.

Beginnen wir damit, eine Figur mit benutzerdefiniertem Styling zu erstellen. Ein Beispielcode ist unten gezeigt:

In diesem Beispiel erstellen wir ein Streudiagramm mit benutzerdefiniertem Textstil wie Schriftfamilie, Schriftfarbe, Schriftgröße usw.

Der obige Code sollte ein einfaches Streudiagramm wie gezeigt zurückgeben:

Wir können diese Figur mit der Funktion to_template() in eine Figur mit einer Stilvorlage umwandeln.

Ein Beispielcode sieht wie folgt aus:

Im obigen Code importieren wir zunächst das plotly io-Modul als io. Wir erstellen dann eine Kopie der Figur, wobei das Styling mithilfe der Funktion to_templated() in einer benutzerdefinierten Vorlage gespeichert wird.

Wir können die Vorlage anzeigen, indem wir den Code ausführen:

Dies sollte ein Wörterbuch mit Eigenschaften zurückgeben, die das Styling der Figur definieren. Ein Beispielausgabewert ist wie gezeigt:

Sie können die Abbildung einfach anzeigen, indem Sie die gespeicherte Vorlage aufrufen als:

Dies sollte die in der Vorlage gespeicherte Figur anzeigen.

Erstellen Sie eine Figur mit der Vorlage

Sobald wir das Styling einer Figur in einer benutzerdefinierten Vorlage gespeichert haben, können wir diese Vorlage verwenden, um das Styling auf eine andere Figur anzuwenden.

Ein Beispielcode sieht wie folgt aus:

Im obigen Beispiel importieren wir zunächst das Modul graph_objects aus Plotly. In diesem Fall verwenden wir graph_objects, da wir eine leere Figur erstellen möchten, aber nur das Styling verwenden.

Mit der Funktion go.Figure() übergeben wir den Layout-Parameter und spezifizieren das Ziel-Template mit der Eigenschaft ‚template‘.

Wir können dann die resultierende Zahl anzeigen, indem wir new_fig aufrufen. Dies sollte zurückgeben:

Beachten Sie, dass die obige Abbildung keine Daten oder Texte enthält. Es enthält nur das Styling, wie Textfarbe, Schriftfamilie, Schriftgröße usw.

Um mit dieser Vorlage ein Streudiagramm zu erstellen, können wir den folgenden Code verwenden:

Das obige Beispiel sollte eine Zahl wie gezeigt zurückgeben:

Beachten Sie, dass Schriftfarbe, Familie und Größe denen in der Vorlage ähnlich sind.

Speichern einer benannten Vorlage

Wir können die benutzerdefinierte Vorlage mit dem Vorlagenobjekt speichern, wie im folgenden Code gezeigt:

Der obige Code speichert die Vorlage unter dem Namen „my_custom_template“. Sie können diesen Namen dann verwenden, um die Vorlage anzugeben, die Sie verwenden möchten:

Fazit

In diesem Tutorial haben wir gelernt, wie man eine Figur mit dem in einer benutzerdefinierten Vorlage gespeicherten Stil erstellt. Wir haben auch behandelt, wie Sie die Vorlage in anderen Abbildungen verwenden und die Vorlage für die spätere Verwendung speichern können.