Guia da API do PyGWalker Gradio

Este guia explica como integrar o PyGWalker com aplicações Gradio, permitindo capacidades de visualização de dados interativa dentro do seu UI do Gradio.

Início Rápido

Para renderizar o PyGWalker em um aplicativo Gradio, use a função 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]})

Função Principal: get_html_on_gradio

Esta função gera o HTML para o PyGWalker ser embutido em uma aplicação Gradio.

Parâmetros Importantes

Parâmetro	Tipo	Padrão	Descrição
dataset	Union[DataFrame, Connector]	-	Fonte de dados de entrada
spec	str	""	Dados de configuração do gráfico (ID, JSON ou URL)
spec_io_mode	Literal["r", "rw"]	"r"	Modo de E/S de configuração: "r" (leitura) ou "rw" (leitura/gravação)
kernel_computation	bool	None	Habilitar computação em núcleo de alto desempenho
appearance	Literal['media', 'light', 'dark']	'media'	Configuração de tema
default_tab	Literal["data", "vis"]	"vis"	Aba padrão a ser exibida

Melhores Práticas

Carregamento de Dados: Carregue seus dados de forma eficiente, considerando cache para grandes conjuntos de dados.
Configuração: Use um arquivo JSON separado para configurações de gráficos (parâmetro spec) para gerenciar e atualizar as visualizações facilmente.
Desempenho: Para grandes conjuntos de dados, defina kernel_computation=True para melhorar o desempenho.
Tematização: Ajuste o parâmetro appearance para coincidir com o tema do seu aplicativo Gradio.
Interatividade: Defina spec_io_mode="rw" para permitir que os usuários modifiquem e salvem as configurações de gráficos.

Uso Avançado

Roteamento Personalizado

Sempre inclua o PYGWALKER_ROUTE nas rotas do seu aplicativo Gradio:

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

Isso garante a comunicação adequada entre o PyGWalker e o seu aplicativo Gradio.

Combinando com Outros Componentes Gradio

Você pode combinar o PyGWalker com outros componentes Gradio para uma ferramenta de análise de dados mais abrangente:

with gr.Blocks() as demo:
    gr.Markdown("# Visualização de Dados com PyGWalker")
 
    with gr.Tab("Explorador PyGWalker"):
        pyg_html = get_html_on_gradio(df, spec="./gw_config.json")
        gr.HTML(pyg_html)
 
    with gr.Tab("Resumo dos Dados"):
        gr.DataFrame(df.describe())
 
    with gr.Tab("Dados Brutos"):
        gr.DataFrame(df)

Solução de Problemas

Se as visualizações não renderizarem, verifique o formato dos dados e certifique-se de que PYGWALKER_ROUTE está adequadamente incluído.
Para problemas de desempenho com grandes conjuntos de dados, tente habilitar kernel_computation e considere técnicas de amostragem de dados.

Para mais informações detalhadas e recursos avançados, consulte a documentação do PyGWalker (opens in a new tab).

Streamlit Component HTML Exports