Plotly.io.write_html

“Os documentos html não são nada de novo. Eles são o que poderes na Internet e em todos os sites que visitamos. Portanto, você encontrará casos em que precisará exportar uma figura de plotagem para um documento HTML. Você pode compartilhar esse documento ou carregá -lo para um servidor da web como uma página estática.”

Neste artigo, exploraremos como podemos usar a função to_html do módulo plotly io para exportar uma figura para uma string html.

Função Sintaxe e Lista de Parâmetros

A função possui uma sintaxe relativamente simples, como mostrado abaixo:

plotly.io.to_html (fig, config = nenhum, auto_play = true, include_plotlyjs = true, include_mathjax = false, post_script = nenhum, full_html = true, animation_opts = nenhum, default_width = '100%', default_height = '100%', valides = verdade div_id = nenhum)

Parâmetros:

1. Fig - Especifica a figura para converter em uma string html.
2. Config - define o plotly.Opções de configuração do JS.
3. Auto_play - Especifica se a animação da figura, se houver, deve começar automaticamente após o carregamento da página.
4. incluir_plotlyjs - define o método em que a plotagem.A biblioteca JS está incluída no arquivo HTML. As opções aceitas incluem:
   1. Verdadeiro - plotly.JS está incluído como uma tag de script que contém o código -fonte para a plotagem.Biblioteca JS. Isso pode levar ao uso offline dos arquivos, mas leva a um grande tamanho de arquivo.
   2. 'CDN' - Esta opção inclui a plotagem.Biblioteca JS como uma tag de script que faz referência a um link CDN.
   3. 'Diretório' - se definido como um diretório, a função incluirá o plotly.Biblioteca JS como uma trama externa.min.pacote js armazenado no mesmo diretório que o arquivo html.
   4. 'requer' - se definido para exigir, plotly.JS é carregado usando requisito.JS.
   5. Falso - plotly.JS não está incluído no arquivo html.
5. Incluir_mathjax - Especifica como o Mathjax.A biblioteca JS está incluída. As opções aceitas são semelhantes às da plotagem.Biblioteca JS.
6. post_script - Especifica os trechos JavaScript incluídos no DIV após a criação da trama.
7. Full_html - Definir se a função deve converter a figura em um documento HTML inteiro começando com tags ou uma string parcial html começando com o elemento.
8. Validar - Especifica se a figura deve ser validada antes de converter para HTML.

A função retornará uma string html representando a figura especificada.

Crie uma figura de amostra

Antes de aprendermos a converter uma figura em uma string html, vamos ter dados de amostra que podemos usar.

Para este tutorial, usaremos uma figura simples de explosão de sol, como mostrado no código abaixo:

importar plotly.expresso como px
dados = dicto (
distros = ['Debian', 'Centos', 'Fedora', 'Red Hat Linux', 'OpenSuse', 'Qubes', 'SUSE Studio', 'Ubuntu', 'Kubuntu', 'Xubuntu'],
Pais = [", 'Red Hat Linux', 'Red Hat Linux',", 'Red Hat Linux', 'Fedora', 'OpenSuse', 'Debian', 'Ubuntu', 'Ubuntu']
)
Fig = px.Sunburst (dados, nomes = 'distos', pais = 'pais', cor = 'distos')
Figo.mostrar()

O código acima deve retornar uma figura como mostrado:

Figura de exportação como string html

Para exportar a figura acima como uma sequência HTML estática, podemos executar o código como mostrado:

importar plotly.io como io
io.to_html (fig, incluir_plotlyjs = 'cdn')

O código acima retornará uma string html que representa o enredo acima do sol. Lembre -se de que a string html incluirá a plotagem.Biblioteca JS como CDN, conforme especificado acima.

A partir da saída acima, podemos ver que o documento HTML começa no elemento.

Para gerar um documento HTML completo, podemos definir o parâmetro full_html como true como mostrado:

importar plotly.io como io
io.to_html (fig, incluir_plotlyjs = 'cdn', full_html = true)

Salvar string html no arquivo

Um recurso útil da função to_html é escrever a sequência HTML resultante em um arquivo html.

Um exemplo é como mostrado:

importar plotly.io como io
Com o Open ('Sunburst.html ',' w ') como f:
f.Escreva (io.to_html (fig, incluir_plotlyjs = 'cdn', full_html = true))

O código acima deve escrever a string html da função to_html para o Sunburst.arquivo html.

Você pode ver este arquivo abrindo -o em seu navegador.

Já que incluímos o plotly.Biblioteca JS como CDN, você precisará de uma conexão de rede para a biblioteca baixar e obter a interatividade completa da figura.

Conclusão

Neste artigo, aprendemos como poderíamos converter um plotly figurar em uma string html usando o IO.função to_html ().

Obrigado pela leitura e codificação feliz!!