Spiski.io.Write_image

Spiski.io.Write_image
Plotly to wszechstronne narzędzie z doskonałymi funkcjami od razu po wyjęciu z pudełka. Jedną z takich funkcji jest możliwość eksportowania wykresów do obrazów statycznych. Korzystając z fabuły, możesz zapisać swoje wykresy jako obrazy różnych formatów na dysku komputera lub osadzić je w notebookach Jupyter.

W tym samouczku dowiemy się, jak eksportować wykresy do obrazów statycznych za pomocą funkcji zapisu_mage (.

Instalowanie wymaganych zależności

Zanim będziesz mógł wykonać dowolny statyczny eksport obrazu, musisz zainstalować silnik eksportowy. W przypadku statycznego eksportu obrazu, fabuły obsługuje silniki Kaleido i Orca.

Chociaż będzie to zależeć od twoich potrzeb, Plotly zaleca użycie Kaleido dla działek z fabuły w wersji 4.9 i więcej. W przypadku starszych wersji użyj pakietu ORCA.

Możesz zainstalować te pakiety za pomocą następujących poleceń:

$ sudo pip instaluj kaleido
$ sudo pip3 instaluj kaleido

Jeśli używasz AnaConda, uruchom polecenie:

$ sudo ceda instaluj -C conda-forge python-kaleido

W przypadku ORCA użyj PIP lub CONDA. Polecenia są zgodne z dostarczonymi:

$ sudo pip instaluj -C plotly -plotly -orca
$ sudo pip3 instaluj -C -cotly -plotly -orca
$ sudo ceda instaluj -C plotly -plotly -orca

Po zainstalowaniu możesz użyć funkcji Write_image () do generowania statycznych obrazów swoich wykresów.

Spiski.io.write_iamge ()

Jak wspomniano, funkcja zapisu () pozwala przekonwertować figurę na obraz statyczny i zapisać ją na dysk jako obiekt zapisujący.

Składnia funkcji jest jak pokazana:

spiski.io.write_image (ryc, plik, format = brak, skala = brak, szerokość = brak, wysokość = brak, validate = true, silnik = „auto”)

Parametry funkcji są zgodne z opisem poniżej:

  1. Rysunek - Określa obiekt figury lub słownik do konwersji na obraz statyczny.
  2. Plik - określa ścieżkę do nazwy pliku lub obiekt zapisujący.
  3. Format - Określa pożądany format obrazu docelowego. Zaakceptowane wartości obejmują:
    • „png”
    • „Webp”
    • „JPG lub JPEG”
    • „svg”
    • „pdf”
    • „eps”

Jeśli format obrazu nie jest określony, funkcja będzie domyślna w formacie domyślnym silnika.

  1. Szerokość - określa szerokość eksportowanego obrazu w pikselach.
  2. Wysokość - ustawia wysokość eksportowanego obrazu w pikselach.
  3. Skala - definiuje współczynnik skali stosowany podczas eksportowania obrazu.
  4. Waliduj - wartość logiczna, która określa, czy liczba powinna zostać zatwierdzona przed wyeksportowaniem go do obrazu statycznego.
  5. Silnik - określa docelowy silnik eksportu obrazu. Zaakceptowane wartości obejmują „kaleido”, „orca” lub „auto”.

Funkcja zwraca typ braku.

Przykład - tworzenie figury

Zilustrujmy, w jaki sposób możemy użyć funkcji Write_image (), aby wyeksportować figurę do obrazu statycznego.

Zacznijmy od wygenerowania działki. Kod jest podany poniżej:

importować fabuły.Wyraź jako PX
df = px.dane.gapminder ().zapytanie („country ==„ Irlandia ”)
Ryc. = PX.bar (df, x = „rok”, y = „pop”, color = "lifeexp")
Figa.pokazywać()

W powyższym przykładzie tworzymy prosty wykres słupkowy za pomocą danych Gapminder. Powstała liczba jest jak pokazana:

Zapisz obraz do pliku

Aby napisać powyższy rysunek do pliku obrazu, możemy użyć funkcji Write_image (), jak pokazano:

Figa.write_image („my_figure.png ', format = „png”)

Powyższy kod powinien wyeksportować figurę jako obraz PNG pod nazwą my_figure.png.

Inne przykłady obejmują:

Figa.write_image („my_figure.jpg ', format =' jpg ')
Figa.write_image („my_figure.WebP ', format = „WebP”)
Figa.write_image („my_figure.svg ', format =' svg ')
Figa.write_image („my_figure.pdf ', format =' pdf ')

Powyższy kod powinien wyeksportować obrazy odpowiednio w JPG, WebP, SVG i PDF.

Pisanie obrazu z niestandardowymi wymiarami

Spółka pozwala określić niestandardowe wymiary podczas eksportowania figury do obrazu statycznego. Oto przykładowy kod:

Figa.write_image („my_figure.png ', format = „png”, szerokość = 1200, wysokość = 800)

Kod powyżej powinien zapisać obraz w 1200 x 800 pikseli.

Określanie silnika eksportowego

Jeśli Kaleido zostanie zainstalowane w systemie, Plotly użyje go domyślnie jako silnik eksportowy. Możemy zastąpić ten parametr, ustawiając parametr silnika, jak pokazano:

Figa.write_image („my_figure.png ', format =' png ', szerokość = 1200, wysokość = 800, silnik =' orca ')

Powyższy kod wymaga zainstalowania ORCA w systemie.

Zamknięcie

W tym samouczku nauczyłeś się, jak eksportować liczby na obrazy statyczne za pomocą fabuły.io.Funkcja write_image ().