Plotly.io.skriv_image

Plotly er et allsidig verktøy med flotte funksjoner rett ut av boksen. En slik funksjon er muligheten til å eksportere grafene dine til statiske bilder. Ved å bruke plottly kan du lagre plottene dine som bilder av forskjellige formater på datamaskinens disk eller legge dem inn i Jupyter -notatbøker.

I denne opplæringen lærer vi hvordan du eksporterer plott til statiske bilder ved hjelp av Writ_image () -funksjonen.

Installere nødvendige avhengigheter

Før du kan utføre en hvilken som helst statisk bildeeksport, må du installere en eksportmotor. For statisk bildeeksport støtter plottly Kaleido- og ORCA -motorene.

Selv om det vil avhenge av dine behov, anbefaler Plotly å bruke Kaleido for plott med plotly versjon 4.9 og over. For gamle versjoner, bruk Orca -pakken.

Du kan installere disse pakkene ved å bruke følgende kommandoer:

$ sudo pip install kaleido
$ sudo pip3 install kaleido

Hvis du bruker Anaconda, kjør kommandoen:

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

For orca, bruk pip eller conda. Kommandoene er som gitt:

$ sudo pip install -c plotly plotly -orca
$ sudo pip3 install -c plotly plotly -orca
$ sudo conda install -c plotly plotly -orca

Når du er installert, kan du bruke Writ_Image () -funksjonen til å generere statiske bilder av tomtene dine.

Plotly.io.skriv_iamge ()

Som nevnt, lar Writ_image () -funksjonen deg konvertere en figur til et statisk bilde og lagre den til disk som et skrevet objekt.

Funksjonssyntaksen er som vist:

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

Funksjonsparametrene er som beskrevet nedenfor:

1. Fig - spesifiserer figurobjektet eller ordboken for å konvertere til et statisk bilde.
2. Fil - definerer banen til filnavnet eller et skrivbart objekt.
3. Format - Angir ønsket målbildeformat. Aksepterte verdier inkluderer:
   • 'png'
   • 'Webp'
   • 'JPG eller JPEG'
   • 'SVG'
   • 'PDF'
   • 'EPS'

Hvis bildeformatet ikke er spesifisert, vil funksjonen standard være motorens standardformat.

1. Bredde - Angir bredden på det eksporterte bildet i piksler.
2. Høyde - Angir høyden på det eksporterte bildet i piksler.
3. Skala - Definerer skalafaktoren som brukes når du eksporterer bildet.
4. Valider - en boolsk verdi som spesifiserer om figuren skal valideres før det eksporterer det til et statisk bilde.
5. Motor - Angir målbildeeksportmotoren. Aksepterte verdier inkluderer "Kaleido", 'Orca' eller 'Auto'.

Funksjonen returnerer en ingen type.

Eksempel - Å lage en figur

La oss illustrere hvordan vi kan bruke Writ_image () -funksjonen til å eksportere en figur til et statisk bilde.

La oss starte med å generere et plot. Koden er som angitt nedenfor:

Importer plotly.uttrykk som px
df = px.data.Gapminder ().spørring ("land == 'Irland'")
Fig = px.Bar (df, x = 'år', y = 'pop', color = "lifeexp")
Fig.forestilling()

I eksemplet over oppretter vi en enkel søylediagram ved hjelp av gapminderdataene. Den resulterende figuren er som vist:

Skriv bilde til fil

For å skrive figuren ovenfor til en bildefil, kan vi bruke Writ_image () -funksjonen som vist:

Fig.skriv_image ('my_figure.png ', format =' png ')

Koden over skal eksportere figuren som et PNG -bilde under navnet my_figure.png.

Andre eksempler inkluderer:

Fig.skriv_image ('my_figure.jpg ', format =' jpg ')
Fig.skriv_image ('my_figure.webp ', format =' webp ')
Fig.skriv_image ('my_figure.svg ', format =' SVG ')
Fig.skriv_image ('my_figure.pdf ', format =' pdf ')

Ovennevnte kode skal eksportere bildene i henholdsvis JPG, Webp, SVG og PDF.

Skrivebilde med tilpassede dimensjoner

Plotly lar deg spesifisere tilpassede dimensjoner når du eksporterer en figur til et statisk bilde. Her er et eksempelkode:

Fig.skriv_image ('my_figure.png ', format =' png ', bredde = 1200, høyde = 800)

Koden over skal lagre bildet i 1200 x 800 piksler.

Spesifisere eksportmotor

Hvis Kaleido er installert på systemet, vil Plotly bruke det som eksportmotor som standard. Vi kan overstyre denne parameteren ved å stille inn motorparameteren som vist:

Fig.skriv_image ('my_figure.png ', format =' png ', bredde = 1200, høyde = 800, motor =' orca ')

Ovennevnte kode krever at du har ORCA installert på systemet ditt.

Lukking

I denne opplæringen lærte du hvordan du eksporterer figurer til statiske bilder ved å bruke plottet.io.writ_image () funksjon.