Handlung.io.write_image

Handlung.io.write_image
Plotly ist ein vielseitiges Werkzeug mit großartigen Funktionen direkt außerhalb der Box. Eine solche Funktion ist die Möglichkeit, Ihre Diagramme in statische Bilder zu exportieren. Mit Plotly können Sie Ihre Handlungen als Bilder verschiedener Formate auf der Scheibe Ihres Computers speichern oder in Jupyter -Notizbücher einbetten.

In diesem Tutorial lernen wir mithilfe der Funktion write_image (), wie Sie Plots in statische Bilder exportieren können.

Installation der erforderlichen Abhängigkeiten

Bevor Sie statische Bildexporte durchführen können, müssen Sie einen Exportmotor installieren. Für statische Bildexporte unterstützt Plotly die Motoren Kaleido und Orca.

Obwohl es von Ihren Anforderungen abhängt, empfiehlt Plotly die Verwendung von Kaleido für Handlungen mit Plotly Version 4.9 und höher. Verwenden Sie für Legacy -Versionen das Orca -Paket.

Sie können diese Pakete mit den folgenden Befehlen installieren:

$ sudo pip install kaleido
$ sudo pip3 install kaleido

Wenn Sie Anaconda verwenden, führen Sie den Befehl aus:

$ sudo conda install -c conda-forge python-kaleido

Verwenden Sie für Orca PIP oder Conda. Die Befehle sind wie angegeben:

$ sudo pip install -c Plotly -Plotly -Orca
$ sudo pip3 install -c Plotly -Plotly -Orca
$ sudo conda install -c Plotly -Plotly -Orca

Nach der Installation können Sie die Funktion write_image () verwenden, um statische Bilder Ihrer Diagramme zu generieren.

Handlung.io.write_iamge ()

Wie bereits erwähnt, können Sie mit der Funktion write_image () eine Figur in ein statisches Bild konvertieren und sie als schriftliches Objekt auf Festplatten speichern.

Die Funktionssyntax ist wie gezeigt:

Handlung.io.write_image (Abb, Datei, format = keine, scale = keine, width = keine, Höhe = Keine, validate = true, Engine = 'auto')

Die Funktionsparameter sind wie nachstehend beschrieben:

  1. Fig. - Gibt das Figurenobjekt oder das Wörterbuch an, um in ein statisches Bild umzuwandeln.
  2. Datei - Definiert den Pfad zum Dateinamen oder eines schriftlichen Objekts.
  3. Format - Gibt das gewünschte Zielbildformat an. Zu den akzeptierten Werten gehören:
    • 'PNG'
    • 'Webp'
    • 'JPG oder JPEG'
    • 'Svg'
    • 'PDF'
    • "EPS"

Wenn das Bildformat nicht angegeben ist.

  1. Breite - Gibt die Breite des exportierten Bildes in Pixel an.
  2. Höhe - Legt die Höhe des exportierten Bildes in Pixel fest.
  3. Skalierung - definiert den beim Exportieren des Bildes verwendeten Skalierungsfaktors.
  4. Validieren - einen booleschen Wert, der angibt, ob die Abbildung vor dem Export in ein statisches Bild validiert werden sollte.
  5. Engine - Gibt die Zielexportmotorin an. Zu den akzeptierten Werten gehören "Kaleido", "Orca" oder "Auto".

Die Funktion gibt keinen Typ zurück.

Beispiel - Erstellen einer Figur

Veranschaulichen wir, wie wir die Funktion write_image () verwenden können, um eine Figur in ein statisches Bild zu exportieren.

Beginnen wir zunächst eine Handlung generieren. Der Code ist wie unten angegeben:

Handlung importieren.als px ausdrücken
df = px.Daten.gapminder ().Abfrage ("Land == 'Irland'")
Abb = Px.bar (df, x = 'Jahr', y = 'pop', color = "LifeExp")
Feige.zeigen()

Im obigen Beispiel erstellen wir ein einfaches Balkendiagramm mit den Gapminder -Daten. Die resultierende Abbildung ist wie gezeigt:

Bild in Datei schreiben

Um die obige Abbildung in eine Bilddatei zu schreiben, können wir die Funktion write_image () wie gezeigt verwenden:

Feige.write_image ('my_figure.png ', format =' png ')

Der obige Code sollte die Abbildung als PNG -Bild unter dem Namen My_Figure exportieren.png.

Weitere Beispiele sind:

Feige.write_image ('my_figure.JPG ', format =' JPG ')
Feige.write_image ('my_figure.webp ', format =' webp ')
Feige.write_image ('my_figure.SVG ', format =' Svg ')
Feige.write_image ('my_figure.pdf ', format =' pdf ')

Der obige Code sollte die Bilder in JPG, WebP, SVG und PDF exportieren.

Bild mit benutzerdefinierten Dimensionen schreiben

Mit Plotly können Sie beim Exportieren einer Figur in ein statisches Bild benutzerdefinierte Dimensionen angeben. Hier ist ein Beispielcode:

Feige.write_image ('my_figure.png ', format =' png ', width = 1200, Höhe = 800)

Der obige Code sollte das Bild in 1200 x 800 Pixel speichern.

Angabe der Exportmotor

Wenn Kaleido auf dem System installiert ist, verwendet Plotly es standardmäßig als Exportmotor. Wir können diesen Parameter überschreiben, indem wir den Motorparameter wie gezeigt einstellen:

Feige.write_image ('my_figure.png ', format =' png ', width = 1200, Höhe = 800, motor =' orca ')

Im obigen Code müssen Sie Orca auf Ihrem System installieren lassen.

Schließen

In diesem Tutorial haben Sie gelernt, wie man Figuren mithilfe der Handlung in statische Bilder exportiert.io.Write_image () Funktion.