Python Academy · Aula

Exportação e incorporação

Salve e compartilhe figuras

Exportação e incorporação é uma aula grátis de Python Academy no CoddyKit. Esta é a aula 4 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de Python Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de Python Academy inclui 4 aulas no total.

Compartilhando seu trabalho

Um gráfico concluído só é útil se outras pessoas puderem vê-lo. As figuras do Plotly podem ser salvas como HTML interativo, exportadas como imagens estáticas ou incorporadas em páginas da Web e relatórios.

A escolha do formato adequado depende de a audiência precisar de interatividade.

Salvando HTML interativo

fig.write_html('chart.html') grava um arquivo independente que mantém toda a interatividade. Abri-lo em qualquer navegador oferece ampliação, dicas ao passar o cursor e deslocamento, sem precisar de Python.

Esse é o melhor formato para compartilhar um gráfico interativo que possa ser explorado.

Escolhendo um nome de arquivo

Dar nomes aos arquivos é importante quando você gera muitas exportações. Um nome com marca temporal e no formato slug evita conflitos. Isso é apenas manipulação de strings.

title = 'Q3 Sales Report!'
slug = ''.join(ch.lower() if ch.isalnum() else '_' for ch in title)
slug = '_'.join(p for p in slug.split('_') if p)
print(slug + '.html')

Exportação de imagem estática

Para PDFs, apresentações ou e-mails, você precisa de uma imagem estática. fig.write_image('chart.png') produz PNG, JPEG, SVG ou PDF. Isso requer que o mecanismo kaleido esteja instalado.

Imagens estáticas perdem a interatividade, mas podem ser incorporadas em qualquer lugar.

Escolhendo um formato

Escolha o formato de acordo com o uso:

HTML exploração interativa e páginas da Web
PNG/JPEG imagem de pixels, adequada para apresentações e e-mails
SVG imagem vetorial, que pode ser ampliada sem perder nitidez na impressão
PDF documentos

Uma pequena tabela de decisão torna a escolha rápida.

use_case = 'print'
format_map = {'web': 'html', 'slides': 'png', 'print': 'svg', 'document': 'pdf'}
print('Best format for', use_case, '->', format_map[use_case])

Incorporando em uma página

Para incorporar em um site existente sem um arquivo HTML completo, use fig.to_html(full_html=False, include_plotlyjs='cdn'). Isso retorna apenas o fragmento HTML do gráfico, que você cola no seu modelo.

Carregar plotly.js de um CDN mantém sua página leve.

Incluindo a biblioteca

O HTML interativo precisa da biblioteca plotly.js. Opções para include_plotlyjs:

True incluí-la no arquivo (grande, funciona off-line)
'cdn' vinculá-la a um CDN (pequeno, requer internet)
False presumir que a página já a carregou

Escolha com base na necessidade de uso off-line e no peso da página.

Resolução da exportação

Para imagens estáticas, controle o tamanho e a nitidez com width, height e scale. Um scale=2 dobra a densidade de pixels, produzindo imagens nítidas em telas de alta resolução.

width, height, scale = 800, 600, 2
print('Output pixels:', width * scale, 'x', height * scale)

Idas e voltas com JSON

Uma figura pode ser serializada com fig.to_json() e reconstruída com plotly.io.from_json(). Isso é útil para armazenar figuras em cache ou enviá-las entre um servidor e um navegador.

O JSON descreve completamente os dados e a disposição.

Reprodutibilidade

Ao compartilhar uma exportação, mantenha também o script que a produziu. Um PNG não pode ser editado novamente, mas o código pode recriar o gráfico com dados novos. Considere o código, e não a imagem, como a fonte de verdade.

Incorporação em notebooks e Markdown

No Jupyter, uma figura é exibida automaticamente em linha quando é a última expressão de uma célula. Para documentação estática, exporte uma imagem e faça referência a ela no Markdown. Para documentação dinâmica, incorpore o fragmento HTML.

Escolha HTML interativo quando for útil que o leitor explore o conteúdo e uma imagem estática quando ele só precisar observá-lo.

Verificação rápida

Teste seus conhecimentos sobre exportação.

Recapitulação

Você aprendeu a compartilhar figuras:

write_html para arquivos independentes interativos
write_image (com kaleido) para PNG/SVG/PDF
to_html(full_html=False) para incorporar um fragmento, com include_plotlyjs controlando a biblioteca
Use scale para imagens de alta resolução e mantenha o código-fonte para garantir a reprodutibilidade

Perguntas Frequentes

A aula “Exportação e incorporação” é grátis?

Sim — o texto completo de “Exportação e incorporação” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de Python Academy, atualize para CoddyKit PRO. O curso de Python Academy inclui 4 aulas no total.

O que vou aprender em “Exportação e incorporação”?

Salve e compartilhe figuras Você pratica Python Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.

Preciso ter experiência prévia para começar Python Academy?

Nenhuma experiência prévia é necessária. Python Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 4 de 4.

Quanto tempo leva a aula “Exportação e incorporação”?

A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.

Posso escrever e executar código nesta aula de Python Academy?

Sim. Cada aula de Python Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.

Todas as aulas deste curso

← Voltar para Python Academy