Guía de la API de PyGWalker Gradio

Esta guía explica cómo integrar PyGWalker con aplicaciones Gradio, habilitando capacidades de visualización de datos interactivas dentro de tu UI de Gradio.

Inicio Rápido

Para renderizar PyGWalker en una aplicación Gradio, usa la función get_html_on_gradio:

import gradio as gr
import pandas as pd
from pygwalker.api.gradio import PYGWALKER_ROUTE, get_html_on_gradio
 
with gr.Blocks() as demo:
    df = pd.read_csv("data.csv")
    pyg_html = get_html_on_gradio(df, spec="./gw_config.json", spec_io_mode="rw")
    gr.HTML(pyg_html)
 
app = demo.launch(app_kwargs={"routes": [PYGWALKER_ROUTE]})

Función Clave: get_html_on_gradio

Esta función genera el HTML para que PyGWalker se integre en una aplicación Gradio.

Parámetros Importantes

Parámetro	Tipo	Por Defecto	Descripción
dataset	Union[DataFrame, Connector]	-	Fuente de datos de entrada
spec	str	""	Datos de configuración del gráfico (ID, JSON o URL)
spec_io_mode	Literal["r", "rw"]	"r"	Modo de E/S de spec: "r" (leer) o "rw" (leer/escribir)
kernel_computation	bool	None	Habilitar cálculo de alto rendimiento del kernel
appearance	Literal['media', 'light', 'dark']	'media'	Configuración del tema
default_tab	Literal["data", "vis"]	"vis"	Pestaña predeterminada para mostrar

Mejores Prácticas

Carga de Datos: Carga tus datos eficientemente, considerando el uso de caché para conjuntos de datos grandes.
Configuración: Usa un archivo JSON separado para las configuraciones de los gráficos (parámetro spec) para gestionar y actualizar visualizaciones fácilmente.
Rendimiento: Para conjuntos de datos grandes, establece kernel_computation=True para mejorar el rendimiento.
Tematización: Ajusta el parámetro appearance para que coincida con el tema de tu aplicación Gradio.
Interactividad: Configura spec_io_mode="rw" para permitir a los usuarios modificar y guardar configuraciones de los gráficos.

Uso Avanzado

Enrutamiento Personalizado

Siempre incluye la ruta PYGWALKER_ROUTE en las rutas de tu aplicación Gradio:

app = demo.launch(app_kwargs={"routes": [PYGWALKER_ROUTE]})

Esto asegura una comunicación adecuada entre PyGWalker y tu aplicación Gradio.

Combinación con Otros Componentes de Gradio

Puedes combinar PyGWalker con otros componentes de Gradio para obtener una herramienta de análisis de datos más completa:

with gr.Blocks() as demo:
    gr.Markdown("# Visualización de Datos con PyGWalker")
 
    with gr.Tab("Explorador PyGWalker"):
        pyg_html = get_html_on_gradio(df, spec="./gw_config.json")
        gr.HTML(pyg_html)
 
    with gr.Tab("Resumen de Datos"):
        gr.DataFrame(df.describe())
 
    with gr.Tab("Datos en Bruto"):
        gr.DataFrame(df)

Resolución de Problemas

Si las visualizaciones no se renderizan, verifica tu formato de datos y asegúrate de que PYGWALKER_ROUTE esté incluido correctamente.
Para problemas de rendimiento con conjuntos de datos grandes, intenta habilitar kernel_computation y considera técnicas de muestreo de datos.

Para más información detallada y características avanzadas, consulta la documentación de PyGWalker (opens in a new tab).

Streamlit Component HTML Exports