Plotly.io.write_json

JSON é um formato popular de intercâmbio de dados que foi adotado pelas principais linguagens de programação. É usado para a comunicação da API e a troca de informações entre os sistemas.

Portanto, não é de surpreender que você precise converter uma figura de plotagem em dados JSON e salvá -los em um arquivo ou objeto escritor. Você pode usar esta corda JSON e analisá -la em um formato facilmente compreendido, como uma imagem PNG.

Vamos aprender como podemos fazer isso usando plotly io.

Plotly.io.write_json ()

O módulo plotly io nos fornece a função write_json () que nos permite converter uma determinada figura em uma string json. Em seguida, podemos salvar a string em um arquivo ou em um objeto Writable.

A sintaxe da função é como mostrado:

plotly.io.write_json (fig, arquivo, validate = true, bonito = false, remove_uids = true, mecanismo = nenhum)

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

1. Fig - Especifica a figura a ser convertida em uma corda JSON.
2. Arquivo - Especifica o caminho para o nome do arquivo onde salvar o valor JSON.
3. Validar - um valor booleano que define se a figura deve ser validada antes de converter para JSON. O valor padrão é verdadeiro.
4. Pretty - se verdadeiro, a sequência JSON retornada está em um formato de impressão bonita. Se false, a string retornada está no modo compacto.
5. Remone_uids - Especifica se os rastreios devem ser removidos da string json. O valor padrão é verdadeiro.
6. Motor - especifica o motor de codificação JSON. Os valores suportados incluem:
   1. 'JSON' - usa o módulo JSON embutido do Python.
   2. 'Orjson' - usa o motor Orjson. É muito mais rápido, mas requer o pacote Orjson instalado no sistema.
   3. 'Auto' - permite que a plotly escolha entre Orjson ou JSON embutido, dependendo daquele disponível.

Exemplo 1

Vamos ver como podemos usar a função write_json () para converter uma figura em uma string json.

importar plotly.expresso como px
importar pandas como PD
df = pd.DataFrame (ditado (
x = [1,2,3,4,5],
y = [1,2,3,4,5]
))
Fig = px.linha (df, x = "x", y = "y")
Figo.mostrar()

No exemplo acima, usamos o plotly expresso para criar um gráfico de linha simples com valores como um quadro de dados de pandas.

A figura resultante é como mostrado:

Podemos exportar a figura acima para uma string json executando o código:

importar plotly.io como io
io.write_json (fig, 'line_graph.JSON ')

No código acima, começamos importando o módulo de IO da Plotly como io. Por fim, chamamos a função write_json () e passamos a figura e o nome do arquivo.

Depois de executar o código acima, devemos ter um arquivo chamado Line_Graph.JSON com os dados JSON da figura, como mostrado na saída abaixo:

Na maioria dos casos, a corda JSON devolvida não é formatada. Você pode corrigir isso definindo o parâmetro bonito como true como mostrado:

importar plotly.io como io
io.write_json (fig, 'line_graph.json ', bonito = true)

O código acima deve retornar a string json em um formato bem formado.

Exemplo 2

Você pode definir o mecanismo JSON de destino usando o parâmetro do motor. Por exemplo, para usar o mecanismo Orjson, podemos executar o código:

importar plotly.io como io
io.write_json (fig, 'line_graph.json ', bonito = verdadeiro, mecanismo =' orjson ')

Se você não possui Orjson instalado, pode fazê -lo executando o comando pip como mostrado:

$ PIP3 Instale Orjson

Fechamento

Neste tutorial, aprendemos como podemos converter uma figura de plotagem em uma string json e salvá -la em um arquivo usando a função write_json ().

Para saber mais sobre a função de Plotly, confira nossos tutoriais sobre o tópico.