Plotly.io.å forestille seg

Når du jobber med Plotlys grafer, vil du møte en forekomst der du trenger å eksportere plottet til en bildefil. Mens du kan dykke ned i eksterne verktøy for å eksportere bildet, har Plotly innebygd funksjonalitet for å oppnå dette.

Gjennom denne opplæringen lærer du hvordan du bruker plottet.io.to_image () funksjon for å lagre en figur som et bilde.

Plotly.io.å forestille seg()

Plottet.io.To_Image () -funksjonen lar deg konvertere en bestemt plottfigur til et statisk bilde.

Funksjonssyntaksen er som vist:

plotly.io.to_image (fig, format = ingen, bredde = ingen, høyde = ingen, skala = ingen, validering = true, motor = 'auto')

Funksjonen godtar parametrene som vist:

1. Fig - representerer figuren som skal konverteres til et statisk bilde.
2. format - Denne parameteren definerer målbildeformatet. Støttede verdier inkluderer: “PNG,” “JPG,” “JPEG,” “SVG,” “Webp,” “EPS,” og “PDF.”
3. bredde - Angir breddedimensjonene til det eksporterte bildet. Denne verdien er gitt i piksler.
4. høyde - definerer høydedimensjonen til bildet i piksler.
5. skala - representerer skalafaktoren når du eksporterer den spesifikke figuren.
6. validert - Angir om bildet skal valideres før det konverterer til bilde. Som standard er denne verdien satt til sann.
7. motor - brukes til å definere bildeeksportmotoren. Støttede motorer inkluderer: “Kaleido”, “Orca” og “Auto.”

Funksjonen returnerer bildedataene i byte.

Eksempel 1

Følgende eksempelkode viser hvordan du eksporterer en enkel figur til et statisk bilde ved hjelp av TO_IMAGE.

Importer plotly.uttrykk som px
Importer numpy som NP
x = np.tilfeldig.Randn (50)
y = np.tilfeldig.Randn (50)
Fig = px.spredning (x = x, y = y)
Fig.forestilling()

I koden over bruker vi Plotly Express -modulen for å lage et enkelt spredningsplott med tilfeldige data fra Numpy Randn -funksjonen.

Den resulterende figuren:

For å eksportere dette tallet, kan vi kjøre koden som:

Importer plotly som PLT
plt.io.to_image (fig, format = 'png')

Koden over skal returnere byte -data fra bildet som vist:

b '\ x89png \ r \ n \ x1a \ n \ x00 \ x00 \ x00 \ rihdr \ x00 \ x00 \ x02 \ xbc \ x00 \ x00 \ x01 \ xf4 \ x08 \ x06 \ x00 \ x00 \ X00
\ xdfy \ xfe \ xdf \ x00 \ x00
----avkortet

Merk at du noen ganger kan møte Kaleido påkrevd feil når du kjører TO_Image () -funksjonen.

Du kan løse dette ved å bruke Kaleido -pakken med PIP som:

$ pip install kaleido
$ pip3 installer kaledio

Når du er installert, må du starte utviklingsmiljøet på nytt og kjøre koden ovenfor på nytt.

Eksempel 2 - Lagre byte til fil

I de fleste tilfeller er det ikke veldig nyttig å ha byte av data. Vi kan imidlertid bruke denne byte og skrive den til en bildefil som vist i koden:

Importer plotly som PLT
med åpen ("Target_Filename.png ", 'wb') som f:
f.Skriv (plt.io.to_image (fig, format = 'png'))

I eksemplet over bruker vi Python -filoperasjonen for å opprette en fil og skrive byte fra TO_Image () -funksjonen. Ovennevnte metode skal opprette en fil med det spesifiserte filnavnet og lagre bildet.

Det resulterende bildet er som vist:

Eksempel 3 - Spesifisere bilde- og høydedimensjoner

For å eksportere bildet med spesifikk bredde og høydedimensjoner, kan vi spesifisere disse parametrene som vist:

Importer plotly som PLT
med åpen ("Target_Filename.png ", 'wb') som f:
f.Skriv (plt.io.to_image (fig, bredde = 1200, høyde = 800, format = 'png'))

I eksemplet over lagrer vi bildet i 1200 × 800 dimensjoner. Vi kan bekrefte dette ved å kjøre kommandoen:

$ Exiftool Target_Filename.png

Dette skal returnere utgangen som vist:

Som vi kan se, har det resulterende bildet 1200 x 800 dimensjoner.

Eksempel 4 - Spesifiser bildeeksportmotor

Plotly lar deg også spesifisere motoren du ønsker å bruke når du eksporterer bildet. Det støtter Kaleido og Orca som motorene.

Et eksempel på hvordan du spesifiserer eksportmotoren vises nedenfor.

Før du spesifiserer en motor, må du forsikre deg om at den er installert og tilgjengelig på banen til systemet ditt.

For eksempel for å installere Kaleido, kjør kommandoen:

$ sudo pip3 install kaleido

For Orca, kjør kommandoen:

conda install -c plotly -orca psutil forespørsler
$ pip3 installer plotly-orca psutil forespørsler

Eksempel:

Importer plotly som PLT
med åpen ("Target_Filename.png ", 'wb') som f:
f.Skriv (plt.io.to_image (fig, bredde = 1200, høyde = 800, format = 'png', motor = "kaleido"))

Eksemplet over illustrerer hvordan du spesifiserer bildeeksportmotoren til Kaleido.

Husk at Plotly vil misligholde bilverdien. Dette betyr at hvis Kaleido ikke er installert, vil Plotly bruke Orca og omvendt.

Konklusjon

I denne artikkelen lærte vi hvordan vi kan eksportere en figur til et statisk bilde som byte ved hjelp av IO.to_image () funksjon. Vi lærte også hvordan du spesifiserer en tilpasset bildestørrelse, skriver byte til disk som et bilde osv.