Plotly.io.write_image

Plotly è uno strumento versatile con ottime caratteristiche subito. Una di queste funzionalità è la possibilità di esportare i tuoi grafici in immagini statiche. Usando la trama, puoi salvare i tuoi grafici come immagini di vari formati sul disco del tuo computer o incorporarli all'interno dei quaderni di Jupyter.

In questo tutorial, impareremo come esportare grafici in immagini statiche usando la funzione write_image ().

Installazione di dipendenze richieste

Prima di poter eseguire qualsiasi esportazione di immagini statiche, è necessario installare un motore di esportazione. Per le esportazioni di immagini statiche, supporta la trama dei motori Kaleido e Orca.

Anche se dipenderà dalle tue esigenze, consiglia di utilizzare Kaleido per trame con Plotly versione 4.9 e sopra. Per le versioni legacy, utilizzare il pacchetto Orca.

È possibile installare questi pacchetti utilizzando i seguenti comandi:

$ sudo pip installa kaleido
$ sudo pip3 installa kaleido

Se stai usando Anaconda, esegui il comando:

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

Per Orca, usa Pip o Conda. I comandi sono come previsti:

$ sudo pip install -c plack -orca
$ sudo pip3 install -c plack -orca
$ sudo conda installazione -c plack -orca

Una volta installato, è possibile utilizzare la funzione write_image () per generare immagini statiche dei tuoi grafici.

Plotly.io.write_iamge ()

Come accennato, la funzione write_image () consente di convertire una figura in un'immagine statica e salvarla su disco come oggetto scrittabile.

La sintassi della funzione è come mostrata:

Plotly.io.write_image (fig, file, format = nessuno, scale = nessuno, width = nessuno, height = nessuno, validate = true, engine = 'auto')

I parametri della funzione sono come descritti di seguito:

1. Fig - Specifica l'oggetto figura o il dizionario per convertire in un'immagine statica.
2. File: definisce il percorso per il nome file o un oggetto scrittabile.
3. Formato: specifica il formato di immagine target desiderato. I valori accettati includono:
   • 'png'
   • 'webp'
   • 'jpg o jpeg'
   • 'svg'
   • 'PDF'
   • 'EPS'

Se il formato dell'immagine non è specificato, la funzione sarà impostata predefinita al formato predefinito del motore.

1. Larghezza: specifica la larghezza dell'immagine esportata in pixel.
2. Altezza: imposta l'altezza dell'immagine esportata in pixel.
3. Scala: definisce il fattore di scala utilizzato durante l'esportazione dell'immagine.
4. Convalida: un valore booleano che specifica se la figura deve essere validata prima di esportarla in un'immagine statica.
5. Motore - Specifica il motore di esportazione di immagini di destinazione. I valori accettati includono "kaleido", "orca" o "auto".

La funzione restituisce un tipo nessuno.

Esempio - Creazione di una figura

Illustriamo come possiamo usare la funzione write_image () per esportare una figura in un'immagine statica.

Cominciamo generando una trama. Il codice è come previsto di seguito:

importazione della trama.esprimere come px
df = px.dati.GapMinder ().query ("country == 'Ireland'")
FIG = px.bar (df, x = 'anno', y = 'pop', color = "lifeexp")
Fico.spettacolo()

Nell'esempio sopra, creiamo un semplice grafico a barre utilizzando i dati GapMinder. La figura risultante è come mostrato:

Scrivi l'immagine su file

Per scrivere la figura sopra su un file di immagine, possiamo usare la funzione write_image () come mostrato:

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

Il codice sopra dovrebbe esportare la figura come immagine PNG sotto il nome My_Figure.png.

Altri esempi includono:

Fico.write_image ('my_figure.jpg ', format =' jpg ')
Fico.write_image ('my_figure.webp ', format =' webp ')
Fico.write_image ('my_figure.svg ', format =' svg ')
Fico.write_image ('my_figure.pdf ', format =' pdf ')

Il codice sopra deve esportare le immagini in JPG, WebP, SVG e PDF, rispettivamente.

Scrivere immagine con dimensioni personalizzate

Plockly consente di specificare le dimensioni personalizzate quando si esporta una figura in un'immagine statica. Ecco un codice di esempio:

Fico.write_image ('my_figure.png ', format =' png ', larghezza = 1200, altezza = 800)

Il codice sopra dovrebbe salvare l'immagine in 1200 x 800 pixel.

Specifica del motore di esportazione

Se Kaleido è installato sul sistema, lo utilizzerà Clamoly come motore di esportazione per impostazione predefinita. Possiamo sovrascrivere questo parametro impostando il parametro del motore come mostrato:

Fico.write_image ('my_figure.png ', format =' png ', larghezza = 1200, altezza = 800, motore =' orca ')

Il codice sopra richiede l'installazione di Orca sul sistema.

Chiusura

In questo tutorial, hai imparato a esportare figure in immagini statiche usando la trama.io.funzione write_image ().