Tramamente.IO.write_image

Plotly es una herramienta versátil con excelentes características justo al aire libre. Una de esas características es la capacidad de exportar sus gráficos a imágenes estáticas. Usando Plotly, puede guardar sus tramas como imágenes de varios formatos en el disco de su computadora o incrustarlas dentro de los cuadernos Jupyter.

En este tutorial, aprenderemos cómo exportar gráficos a imágenes estáticas utilizando la función write_image ().

Instalación de dependencias requeridas

Antes de que pueda realizar cualquier exportación de imágenes estáticas, debe instalar un motor de exportación. Para las exportaciones de imágenes estáticas, Plotly admite los motores Kaleido y Orca.

Aunque dependerá de sus necesidades, Plotly recomienda usar Kaleido para tramas con Plotly Versión 4.9 y más. Para versiones heredadas, use el paquete ORCA.

Puede instalar estos paquetes utilizando los siguientes comandos:

$ sudo pip install kaleido
$ sudo Pip3 Instalar Kaleido

Si está utilizando Anaconda, ejecute el comando:

$ sudo conda instalación -c conda-forge python-kaleido

Para orca, use pip o cond a. Los comandos son los que se proporcionan:

$ sudo pip instalación -c tramly tramly -órca
$ sudo pip3 instalación -c tramly tramly -órca
$ sudo conda instalación -c tramly tramly -órca

Una vez instalado, puede usar la función write_image () para generar imágenes estáticas de sus tramas.

Tramamente.IO.write_iamge ()

Como se mencionó, la función Write_Image () le permite convertir una figura en una imagen estática y guardarla en el disco como un objeto escritable.

La sintaxis de la función es como se muestra:

tramamente.IO.Write_Image (fig, archivo, formato = none, scale = none, width = none, hight = none, validate = true, motor = 'Auto')

Los parámetros de la función son los que se describen a continuación:

1. Fig: especifica el objeto de la figura o el diccionario para convertir a una imagen estática.
2. Archivo: define la ruta al nombre de archivo o un objeto escritable.
3. Formato: especifica el formato de imagen objetivo deseado. Los valores aceptados incluyen:
   • 'PNG'
   • 'WebP'
   • 'JPG o JPEG'
   • 'SVG'
   • 'PDF'
   • 'EPS'

Si no se especifica el formato de imagen, la función predeterminará el formato predeterminado del motor.

1. Ancho: especifica el ancho de la imagen exportada en píxeles.
2. Altura: establece la altura de la imagen exportada en píxeles.
3. Escala: define el factor de escala utilizado al exportar la imagen.
4. Validar: un valor booleano que especifica si la cifra debe validarse antes de exportarla a una imagen estática.
5. Motor: especifica el motor de exportación de imágenes de destino. Los valores aceptados incluyen "Kaleido", 'Orca' o 'Auto'.

La función devuelve un tipo de Ninguno.

Ejemplo - Crear una figura

Ilustremos cómo podemos usar la función write_image () para exportar una figura a una imagen estática.

Comencemos generando una trama. El código se proporciona a continuación:

Importar trama.expresar como PX
DF = PX.datos.GABMINDER ().consulta ("país == 'Irlanda'")
Fig = PX.bar (df, x = 'año', y = 'pop', color = "lifeExp")
higo.espectáculo()

En el ejemplo anterior, creamos un gráfico de barras simple utilizando los datos de Gapminder. La figura resultante es como se muestra:

Escribir imagen en el archivo

Para escribir la figura de arriba en un archivo de imagen, podemos usar la función write_image () como se muestra:

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

El código anterior debe exportar la figura como una imagen PNG bajo el nombre my_figure.png.

Otros ejemplos incluyen:

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

El código anterior debe exportar las imágenes en JPG, WebP, SVG y PDF, respectivamente.

Escribir imagen con dimensiones personalizadas

Plotly le permite especificar dimensiones personalizadas al exportar una figura a una imagen estática. Aquí hay un código de ejemplo:

higo.write_image ('my_figure.png ', format =' png ', ancho = 1200, altura = 800)

El código de arriba debe guardar la imagen en 1200 x 800 píxeles.

Especificar el motor de exportación

Si Kaleido se instala en el sistema, Plotly lo usará como motor de exportación de forma predeterminada. Podemos anular este parámetro configurando el parámetro del motor como se muestra:

higo.write_image ('my_figure.png ', format =' png ', ancho = 1200, altura = 800, motor =' orca ')

El código anterior requiere que tenga instalado Orca en su sistema.

Clausura

En este tutorial, aprendió a exportar figuras a imágenes estáticas utilizando la trama.IO.función write_image ().