Tramamente.IO.write_json

JSON es un formato de intercambio de datos popular que ha sido adoptado por los principales lenguajes de programación. Se utiliza para la comunicación API y el intercambio de información en todos los sistemas.

Por lo tanto, no es sorprendente que necesite convertir una figura complentamente en datos JSON y guardarlo en un archivo o objeto escritable. Luego puede usar esta cadena JSON y analizarla en un formato fácil de entender, como una imagen PNG.

Aprendamos cómo podemos lograr esto usando Plotly IO.

Tramamente.IO.write_json ()

El módulo IO Plotly nos proporciona la función write_json () que nos permite convertir una figura dada en una cadena JSON. Luego podemos guardar la cadena en un archivo o en un objeto escritable.

La sintaxis de la función es como se muestra:

tramamente.IO.write_json (fig, archivo, validate = true, bonito = false, remove_uids = true, motor = none)

Los parámetros de la función son los que se muestran a continuación:

1. Fig: especifica la figura que se convertirá en una cadena JSON.
2. Archivo: especifica la ruta al nombre de archivo donde guardar el valor JSON.
3. Validar: un valor booleano que define si la cifra debe validarse antes de convertirse en JSON. El valor por defecto es verdadero.
4. Bastante: si es cierto, la cadena JSON devuelta está en un formato bastante impreso. Si False, la cadena devuelta está en modo compacto.
5. Remove_uids: especifica si se deben eliminar los UID de traza de la cadena JSON. El valor por defecto es verdadero.
6. Motor: especifica el motor de codificación JSON. Los valores compatibles incluyen:
   1. 'JSON' - Utiliza el módulo JSON incorporado de Python.
   2. 'Orjson' - usa el motor Orjson. Es mucho más rápido pero requiere el paquete Orjson instalado en el sistema.
   3. 'Auto': permite a Plotly elegir entre Orjson o JSON incorporado dependiendo de la disponible.

Ejemplo 1

Veamos cómo podemos usar la función write_json () para convertir una figura en una cadena JSON.

Importar trama.expresar como PX
importar pandas como PD
DF = PD.DataFrame (dict (
x = [1,2,3,4,5],
y = [1,2,3,4,5]
))
Fig = PX.línea (df, x = "x", y = "y")
higo.espectáculo()

En el ejemplo anterior, usamos Plotly Express para crear un gráfico de línea simple con valores como un marco de datos PANDAS.

La figura resultante es como se muestra:

Podemos exportar la figura anterior a una cadena JSON ejecutando el código:

Importar trama.io como io
IO.write_json (fig, 'line_graph.json ')

En el código anterior, comenzamos importando el módulo IO de Plotly como IO. Finalmente, llamamos a la función write_json () y pasamos la figura y el nombre de archivo.

Una vez que ejecutamos el código anterior, debemos tener un archivo llamado Line_Graph.JSON con los datos JSON de la figura como se muestra en la salida a continuación:

En la mayoría de los casos, la cadena JSON devuelta no está formateada. Puede arreglarlo configurando el parámetro bonito en verdadero como se muestra:

Importar trama.io como io
IO.write_json (fig, 'line_graph.json ', bonito = verdadero)

El código anterior debe devolver la cadena JSON en un formato bien formateado.

Ejemplo 2

Puede configurar el motor JSON de destino utilizando el parámetro del motor. Por ejemplo, para usar el motor Orjson, podemos ejecutar el código:

Importar trama.io como io
IO.write_json (fig, 'line_graph.json ', bonito = true, motor =' orjson ')

Si no tiene a Orjson instalado, puede hacerlo ejecutando el comando PIP como se muestra:

$ PIP3 Instalar orjson

Clausura

En este tutorial, aprendimos cómo podemos convertir una figura complentamente en una cadena JSON y guardarlo en un archivo usando la función write_json ().

Para obtener más información sobre la función de Plotly, consulte nuestros tutoriales sobre el tema.