Plotly.io.write_image

Plotly é uma ferramenta versátil com ótimos recursos imediatamente. Um desses recursos é a capacidade de exportar seus gráficos para imagens estáticas. Usando plotly, você pode salvar suas parcelas como imagens de vários formatos no disco do seu computador ou incorporá -las dentro de notebooks Jupyter.

Neste tutorial, aprenderemos a exportar gráficos para imagens estáticas usando a função write_image ().

Instalando as dependências necessárias

Antes de executar qualquer exportação de imagem estática, você precisa instalar um mecanismo de exportação. Para exportações de imagens estáticas, Plotly suporta os motores Kaleido e Orca.

Embora dependa de suas necessidades, a Plotly recomenda o uso do Kaleido para tramas com plotagem versão 4.9 e acima. Para versões herdadas, use o pacote ORCA.

Você pode instalar esses pacotes usando os seguintes comandos:

$ sudo pip install kaleido
$ sudo pip3 install kaleido

Se você estiver usando o Anaconda, execute o comando:

$ sudo condata install -c conda-forge python-kaleido

Para Orca, use Pip ou conda. Os comandos são conforme fornecido:

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

Depois de instalado, você pode usar a função write_image () para gerar imagens estáticas de suas parcelas.

Plotly.io.write_iamge ()

Como mencionado, a função write_image () permite converter uma figura em uma imagem estática e salvá -la no disco como um objeto escritor.

A sintaxe da função é como mostrado:

plotly.io.write_image (fig, arquivo, formato = nenhum, escala = nenhum, largura = nenhum, altura = nenhum, validate = true, mecanismo = 'auto')

Os parâmetros da função são os descritos abaixo:

1. Fig - Especifica o objeto ou dicionário da figura para converter em uma imagem estática.
2. Arquivo - Define o caminho para o nome do arquivo ou um objeto Writable.
3. Formato - Especifica o formato de imagem de destino desejado. Os valores aceitos incluem:
   • 'png'
   • 'webp'
   • 'jpg ou jpeg'
   • 'svg'
   • 'pdf'
   • 'Eps'

Se o formato da imagem não for especificado, a função padrão no formato padrão do mecanismo.

1. Largura - Especifica a largura da imagem exportada em pixels.
2. Altura - define a altura da imagem exportada em pixels.
3. Escala - define o fator de escala usado ao exportar a imagem.
4. Validar - um valor booleano que especifica se a figura deve ser validada antes de exportá -lo para uma imagem estática.
5. Motor - especifica o mecanismo de exportação de imagem de destino. Os valores aceitos incluem "Kaleido", 'Orca' ou 'Auto'.

A função retorna um tipo nenhum.

Exemplo - Criando uma figura

Vamos ilustrar como podemos usar a função write_image () para exportar uma figura para uma imagem estática.

Vamos começar gerando um enredo. O código é conforme fornecido abaixo:

importar plotly.expresso como px
df = px.dados.gapminder ().consulta ("country == 'Ireland'")
Fig = px.bar (df, x = 'ano', y = 'pop', color = "lifeexp")
Figo.mostrar()

No exemplo acima, criamos um gráfico de barras simples usando os dados do Gapminder. A figura resultante é como mostrado:

Escreva imagem para arquivo

Para escrever a figura acima em um arquivo de imagem, podemos usar a função write_image () como mostrado:

Figo.write_image ('my_figure.png ', formato =' png ')

O código acima deve exportar a figura como uma imagem PNG sob o nome My_figure.png.

Outros exemplos incluem:

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

O código acima deve exportar as imagens em jpg, webp, svg e pdf, respectivamente.

Escrevendo imagem com dimensões personalizadas

Plotly permite especificar dimensões personalizadas ao exportar uma figura para uma imagem estática. Aqui está um código de exemplo:

Figo.write_image ('my_figure.png ', formato =' png ', largura = 1200, altura = 800)

O código acima deve salvar a imagem em 1200 x 800 pixels.

Especificando mecanismo de exportação

Se o Kaleido estiver instalado no sistema, plotly o usará como mecanismo de exportação por padrão. Podemos substituir este parâmetro definindo o parâmetro do mecanismo como mostrado:

Figo.write_image ('my_figure.png ', formato =' png ', largura = 1200, altura = 800, motor =' orca ')

O código acima exige que você tenha o ORCA instalado em seu sistema.

Fechamento

Neste tutorial, você aprendeu a exportar números para imagens estáticas usando a plotagem.io.função write_image ().