PyGWalker Gradio API Anleitung

Diese Anleitung erklärt, wie man PyGWalker in Gradio-Anwendungen integriert und interaktive Datenvisualisierungen innerhalb der Gradio-Oberfläche ermöglicht.

Schnellstart

Um PyGWalker in einer Gradio-App zu rendern, verwenden Sie die Funktion 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]})

Schlüssel-Funktion: get_html_on_gradio

Diese Funktion generiert das HTML für PyGWalker, das in eine Gradio-Anwendung eingebettet wird.

Wichtige Parameter

Parameter	Typ	Standard	Beschreibung
dataset	Union[DataFrame, Connector]	-	Eingabe-Datenquelle
spec	str	""	Diagrammkonfigurationsdaten (ID, JSON oder URL)
spec_io_mode	Literal["r", "rw"]	"r"	Spec I/O Modus: "r" (lesen) oder "rw" (lesen/schreiben)
kernel_computation	bool	None	Aktiviert Hochleistungsberechnungen
appearance	Literal['media', 'light', 'dark']	'media'	Theme-Einstellungen
default_tab	Literal["data", "vis"]	"vis"	Standard-Tab zur Anzeige

Beste Praktiken

Daten Laden: Laden Sie Ihre Daten effizient und berücksichtigen Sie das Caching für große Datensätze.
Konfiguration: Verwenden Sie eine separate JSON-Datei für Diagrammkonfigurationen (Parameter spec), um Visualisierungen leicht zu verwalten und zu aktualisieren.
Performance: Setzen Sie für große Datensätze kernel_computation=True, um die Leistung zu verbessern.
Theming: Passen Sie den Parameter appearance an das Theme Ihrer Gradio-App an.
Interaktivität: Setzen Sie spec_io_mode="rw", um Benutzern zu erlauben, Diagrammkonfigurationen zu ändern und zu speichern.

Erweitert Anwendung

Benutzerdefinierte Routen

Integrieren Sie immer den PYGWALKER_ROUTE in die Routen Ihrer Gradio-App:

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

Dies gewährleistet eine ordnungsgemäße Kommunikation zwischen PyGWalker und Ihrer Gradio-App.

Kombination mit anderen Gradio-Komponenten

Sie können PyGWalker mit anderen Gradio-Komponenten kombinieren, um ein umfassenderes Datenanalysetool zu erstellen:

with gr.Blocks() as demo:
    gr.Markdown("# Datenvisualisierung mit PyGWalker")
 
    with gr.Tab("PyGWalker Explorer"):
        pyg_html = get_html_on_gradio(df, spec="./gw_config.json")
        gr.HTML(pyg_html)
 
    with gr.Tab("Datenübersicht"):
        gr.DataFrame(df.describe())
 
    with gr.Tab("Rohdaten"):
        gr.DataFrame(df)

Fehlerbehebung

Wenn die Visualisierungen nicht gerendert werden, überprüfen Sie Ihr Datenformat und stellen Sie sicher, dass PYGWALKER_ROUTE korrekt integriert ist.
Bei Leistungsproblemen mit großen Datensätzen versuchen Sie, kernel_computation zu aktivieren und erwägen Sie Datensampling-Techniken.

Für detailliertere Informationen und erweiterte Funktionen konsultieren Sie die PyGWalker Dokumentation (opens in a new tab).

Streamlit Component HTML Exports