Guide de l'API PyGWalker Gradio

Ce guide explique comment intégrer PyGWalker aux applications Gradio, permettant des capacités de visualisation de données interactives au sein de votre interface utilisateur Gradio.

Démarrage rapide

Pour afficher PyGWalker dans une application Gradio, utilisez la fonction 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]})

Fonction clé : get_html_on_gradio

Cette fonction génère le code HTML pour intégrer PyGWalker dans une application Gradio.

Paramètres importants

Paramètre	Type	Par défaut	Description
dataset	Union[DataFrame, Connector]	-	Source de données d'entrée
spec	str	""	Données de configuration du graphique (ID, JSON, ou URL)
spec_io_mode	Literal["r", "rw"]	"r"	Mode I/O de spec : "r" (lecture) ou "rw" (lecture/écriture)
kernel_computation	bool	None	Activer le calcul haute performance
appearance	Literal['media', 'light', 'dark']	'media'	Paramètre de thème
default_tab	Literal["data", "vis"]	"vis"	Onglet par défaut affiché

Bonnes pratiques

Chargement des données : Chargez vos données efficacement, en considérant la mise en cache pour les grands ensembles de données.
Configuration : Utilisez un fichier JSON séparé pour les configurations des graphiques (paramètre spec) afin de facilement gérer et mettre à jour les visualisations.
Performance : Pour les grands ensembles de données, définissez kernel_computation=True pour améliorer les performances.
Thématisation : Ajustez le paramètre appearance pour correspondre au thème de votre application Gradio.
Interactivité : Réglez spec_io_mode="rw" pour permettre aux utilisateurs de modifier et sauvegarder les configurations des graphiques.

Utilisation avancée

Routage personnalisé

Incluez toujours le PYGWALKER_ROUTE dans les routes de votre application Gradio :

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

Cela assure la communication correcte entre PyGWalker et votre application Gradio.

Combiner avec d'autres composants Gradio

Vous pouvez combiner PyGWalker avec d'autres composants Gradio pour un outil d'analyse de données plus complet :

with gr.Blocks() as demo:
    gr.Markdown("# Visualisation des données avec PyGWalker")
 
    with gr.Tab("Explorateur PyGWalker"):
        pyg_html = get_html_on_gradio(df, spec="./gw_config.json")
        gr.HTML(pyg_html)
 
    with gr.Tab("Résumé des données"):
        gr.DataFrame(df.describe())
 
    with gr.Tab("Données brutes"):
        gr.DataFrame(df)

Dépannage

Si les visualisations ne s'affichent pas, vérifiez le format de vos données et assurez-vous que PYGWALKER_ROUTE est correctement inclus.
Pour les problèmes de performance avec les grands ensembles de données, essayez d'activer kernel_computation et envisagez des techniques d'échantillonnage de données.

Pour plus d'informations détaillées et de fonctionnalités avancées, consultez la documentation PyGWalker (opens in a new tab).

Streamlit Component HTML Exports