Plotly.io.to_html

Hypertext Markup Language ou documentos HTML são documentos de marcação que permitem exibir informações na World Wide Web. Quando você está visualizando um site específico, você está usando um documento HTML.

Portanto, não é surpresa que você precise converter uma figura específica em uma string html.

Neste tutorial, aprenderemos a usar o módulo plotly io para converter uma figura em uma representação de string html.

Vamos mergulhar.

Plotly.io.função to_html ()

A função to_html () do módulo IO da Plotly permite que você passe uma figura específica como um parâmetro e converta -o em uma string html.

A sintaxe da função é expressa 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)

Vamos explorar os parâmetros da função, abaixo:

1. Fig - refere -se ao objeto da figura ou à representação do dicionário da figura.
2. Config - Especifica o plotly.Opções de configuração do JS. Passe as opções de configuração como um dicionário.
3. Auto_play - determina se a sequência de animação deve ser reproduzida automaticamente na página Carregar. Este parâmetro é útil se você tiver uma figura contendo quadros animados.
4. Incluir_plotlyjs - Este parâmetro especifica como a plotagem.A biblioteca JS está incluída no HTML. Os valores aceitos neste parâmetro incluem:
   • Verdadeiro - inclui o plotly.Biblioteca JS como uma tag de script no documento HTML. Isso aumentará o tamanho do arquivo, mas permitirá que o arquivo seja usado em ambientes offline.
   • 'CDN' - Configurando o parâmetro Incluir_plotlyjs como 'CDN' adicionará uma tag de script apontando para um link remoto para o plotly.Biblioteca JS. Use esta opção quando em um ambiente em rede ou ambiente sensível ao tamanho do arquivo.
   • 'Diretório' - inclui uma etiqueta de script que aponta para uma plotagem externa.min.JS Bundle localizado no mesmo diretório que o documento HTML.
   • 'requer' - definir o valor a ser exigido carregará a plotagem.biblioteca JS usando requer.JS. Verifique se isso exige.JS está instalado e disponível globalmente no sistema.
   • 'False' - não inclui a trama.Biblioteca JS. Evite esse valor ao definir o parâmetro full_html como true, pois ele tornará o documento inteiro, inutilizável.
5. Incluir_mathjax - Especifica se o arquivo deve incluir o Mathjax.Biblioteca JS. Os valores aceitos são semelhantes a incluir_plotlyjs, exceto o valor 'requer'.
6. Post_script - permite que você inclua trechos JavaScript que são executados após a criação da trama.
7. Full_html - Se true, a função retornará uma string contendo todo o documento HTML, começando com as tags. Se false, a função retornará uma string html começando com o elemento.
8. Animation_Opts - Permite especificar propriedades de animação personalizadas como um dicionário. Esses valores são então passados ​​para a trama.Função animada em plotagem.JS.
9. Default_width - Especifica a largura padrão da figura resultante em pixels.
10. Default_Height - Especifica a altura padrão da figura em pixels.
11. Validar - determina se a figura deve ser validada antes de ser convertida em uma string html.
12. Div_id - especifica um valor do atributo de identificação da tag div, onde o gráfico está localizado.

Em seguida, a função retorna uma representação de string da figura como uma string.

Exemplo de uso

O código a seguir mostra como usar a função to_html para converter uma figura em uma representação de string html.

importar plotly.expresso como px
df = px.dados.ações (indexadas = true)
Fig = px.área (df, facet_col = 'Company', facet_col_wrap = 2)
Figo.mostrar()

No exemplo acima, começamos importando o módulo Plotly Express como px. Em seguida, criamos um quadro de dados usando os dados de estoque de plotagem.

Finalmente, criamos um gráfico de área facetada usando o PX.função de área. Isso deve retornar uma figura como mostrado abaixo:

Podemos converter a figura acima em uma representação de string html, como mostrado no código abaixo:

importar plotly.io como io
io.to_html (fig, full_html = false)

A execução do código acima deve retornar uma string HTML enorme, como mostrado na captura de tela abaixo:

Observe que o documento HTML começa no elemento. Se você deseja incluir o arquivo HTML inteiro, defina o parâmetro full_html = true como mostrado:

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

Observe que a marcação começa na tag.

Para incluir plotly.JS, podemos definir o parâmetro como:

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

No exemplo acima, dizemos a função para incluir a plotagem.Biblioteca JS através de um link CDN.

Podemos verificar isso na saída abaixo:

A melhor maneira de usar o documento TO_HTML é exportando a sequência HTML para um arquivo html.

Podemos fazer isso executando um código simples, como mostrado abaixo:

importar plotly.io como io
com open ('facetted.html ',' w ') como f:
f.Writelines (io.to_html (fig, incluir_plotlyjs = 'cnd', full_html = true))

Neste exemplo, usamos o módulo de arquivo em Python para escrever a string html como um arquivo html.

Podemos então abrir o documento HTML no navegador e ver a figura como mostrado:

Conclusão

Parabéns, você exportou com sucesso sua figura de plotagem como uma string html usando a plotagem.io.Função para_html.