Área de análise: tabela dinâmica e vários gráficos

O gráfico e a estatística

A aba de uma tabela tem dois modos, nos botões Dados e Análise da barra. Dados é a tabela de sempre; Análise é uma prancheta em que convivem quantos gráficos e tabelas dinâmicas você quiser sobre a mesma fonte — cada um num cartão, com título editável, um botão de engrenagem que revela os seletores e um menu ⋮ (mover, duplicar, remover).

Estatística de verdade. Além de barras, linha e dispersão, o gráfico faz caixa (boxplot): uma caixa por categoria com os quartis, a mediana em traço grosso e as hastes na cerca de Tukey (1,5 × IQR) — e não no mínimo e no máximo. Sobre a média de uma coluna, o seletor Erro acrescenta a haste de dispersão: ± desvio padrão (que descreve os dados), ± erro padrão ou ± IC 95% (que descrevem a precisão da própria média). As três só aparecem com a média escolhida, porque "soma ± desvio" não quer dizer nada. A caixa Eixo Y log põe a escala logarítmica, para dados que varrem ordens de grandeza; havendo valor zero ou negativo ela é ignorada com aviso, porque ali o logaritmo não existe e descartar o ponto em silêncio faria o gráfico mentir. Na dispersão, Tendência desenha a reta de regressão com o R², ajustada no banco sobre todas as linhas — e não sobre os pontos amostrados que aparecem na tela. Sob o desenho fica uma linha de estatística descritiva da coluna escolhida (n, média, desvio, IC 95%, mínimo, quartis, mediana e máximo), que é uma consulta própria: derivá-la das barras daria a média das médias, que só coincide com a média real quando todos os grupos têm o mesmo tamanho.

Tabela dinâmica e totais

Tabela dinâmica. Escolha os campos que vão em Linhas e em Colunas (dá para aninhar mais de um em cada eixo; arrastar reordena os níveis), o campo em Valor e como reduzi-lo: Soma, Contagem, Contagem distinta, Média, Mínimo ou Máximo. Sem campo em Valor, contam-se as linhas. Ela também está na mini-barra lateral da tabela, ao lado do Gráfico, para uma consulta rápida sem sair dos dados.

A agregação roda no banco e volta já reduzida — nenhuma linha crua sobe, então um Parquet de dezenas de milhões de linhas continua viável. Como a consulta é SQL padrão, a tabela dinâmica funciona em todos os bancos do cliente SQL (SQLite, DuckDB, PostgreSQL, MySQL, SQL Server e Oracle), e não só no DuckDB como o gráfico.

Totais. As caixas Totais de linha e Totais de coluna acrescentam a linha e a coluna de fecho. Na Média o total é ponderado, e não a média das médias — que estaria errada quando os grupos têm tamanhos diferentes. A Contagem distinta não pode ser totalizada (a união de conjuntos distintos não sai da soma das partes), então ali as caixas ficam desabilitadas, com o motivo no tooltip, em vez de mostrar um número errado.

Onde fica gravado, CSV e agrupar

Onde a análise fica gravada. Num JSON ao lado do arquivo de dados (vendas.parquet → vendas.parquet.analise.json): formato aberto, que vai para o Git junto com o dado e viaja com ele para um colega. O botão Arquivo da análise abre esse JSON numa aba, e esvaziar a análise apaga o arquivo. Uma pasta inteira aberta como tabela não tem caminho próprio, então essa análise não é gravada — o botão diz isso. Cada cartão tem ainda Adicionar à nota do dia: o gráfico vai como bloco mermaid — que a nota desenha e que continua editável — quando tem essa forma (barras, linha, histograma e pizza; dispersão e caixa vão como imagem), e a tabela dinâmica como tabela Markdown, que na nota continua sendo texto para copiar e editar. No resultado de uma consulta SQL a mesma prancheta abre pelo botão Área de análise do rodapé, agregando no mesmo lugar que o gráfico daquele resultado (a cópia local ou o banco); ali ela não é gravada, porque um resultado não tem arquivo ao lado — o que importa vai para a nota pelo Adicionar à nota do dia.

Relatório e cópia. O botão Copiar de cada gráfico oferece Copiar como Mermaid, Copiar os dados (tabela Markdown) — os valores que o gráfico mostra, já agregados, com os números alinhados à direita — e Copiar imagem; o que o Mermaid não leva (barra de erro, eixo log) é dito na hora. Na barra da Área de análise, Copiar relatório junta a análise inteira em Markdown — uma linha com a fonte, o filtro em vigor e a data, e um título por cartão com o gráfico em Mermaid ou a tabela — e Relatório na nota do dia a leva direto para lá. A Pizza mostra partes de um todo: aceita só Soma e Contagem, desenha as maiores categorias e soma as demais em “Outros”, dizendo quantas foram somadas.

Em todas as tabelas. O gráfico, a tabela dinâmica e a Área de análise existem também na planilha Excel, no texto delimitado (inclusive ainda não salvo), nas Tarefas (a vista Análise, guardada dentro do quadro), nas Bases (o botão Análise, gravado ao lado do .lnq sem alterar a Base) e na Tabela personalizada (botão Análise; a coluna de senha fica de fora). Nessas telas o dado mora em memória: no primeiro filtro ou na primeira análise ele é copiado para o DuckDB, e o filtro da grade passa a usar a mesma regra da análise — o gráfico descreve exatamente as linhas que a grade mostra. A planilha soma o valor gravado (a célula que exibe “R$ 3.750,50” soma 3750,5) e filtra pelo texto exibido, que é o que se digita. Quando a tela carregou só parte do arquivo (planilha acima do limite, leitura tolerante cortada), a análise recusa agregar e diz por quê: a soma de uma parte seria um número errado.

Qualidade dos dados. O botão Qualidade da tabela abre, ao lado da grade, um cartão por coluna com o que ela tem de fato: a barra de linhas com valor, vazias (texto vazio ou só espaços) e nulas — contadas separado, porque vazio não é nulo —, quantos valores distintos há e quantos aparecem uma vez só; nas colunas numéricas, média, desvio, quartis, zeros, negativos e discrepantes (fora da cerca de Tukey, a mesma do boxplot), com um mini-histograma; nas de texto, o comprimento e os padrões de formato. Os mais frequentes são clicáveis: o clique vira uma seleção (veja abaixo), e outro valor da mesma coluna a troca. Os alertas apontam coluna sem valor, constante, possível chave, metade ou mais sem valor, muitos zeros, distribuição muito assimétrica e número guardado como texto. O perfil é do conjunto inteiro com o filtro em vigor — nunca de uma amostra —, calculado no DuckDB, até 60 colunas. O resumo se copia como tabela Markdown ou vai para a nota do dia; e na Área de análise o botão Qualidade acrescenta o mesmo perfil como cartão, que entra no relatório como tabela (uma linha por coluna). Uma análise com cartão de qualidade só abre desta versão do LightNote em diante.

Seleções e “mostrar como”. Clicar numa barra ou fatia do gráfico, numa faixa do histograma, dar duplo clique numa célula da tabela dinâmica ou clicar num valor frequente do painel Qualidade filtra a tabela por aquilo — e o filtro vira uma seleção, uma etiqueta sobre a grade (uf = “SP”, valor ≥ 10 e < 20) com um X para tirá-la. As seleções entram sempre por E, fora do grupo do painel Filtro: com o grupo combinando por OU, a seleção estreita o recorte em vez de alargá-lo; mexer no painel de filtro não as tira, e outra seleção na mesma coluna troca a anterior. A seleção compara o valor gravado — a categoria que o gráfico agrupou —; a faixa do histograma vai do início dela até o começo da próxima, e a última não tem teto. A categoria agrupada pelo padrão (o padrão não é um valor da tabela) e a fatia Outros não filtram, e o gráfico e a tabela dinâmica dizem por quê. A Área de análise, o perfil e a legenda do relatório seguem as seleções. Na tabela dinâmica, Mostrar como reescreve os valores já agregados: % do total geral, % do total da linha, % do total da coluna, total acumulado e diferença para a linha anterior. Percentual e acumulado só valem com Soma ou Contagem — somar médias ou mínimos não dá o total de nada —, e a base do cálculo aparece sobre a matriz e no relatório.

Num CSV, um gesto só — e a saída quando o separador engana. Abrir como tabela abre pelo DuckDB, com SQL livre, gráfico, tabela dinâmica e área de análise. Às vezes o separador não é reconhecido (linhas com número de colunas diferente costumam causar isso) e a tabela vem com uma coluna só, a linha inteira dentro dela. Quando isso acontece, uma faixa aparece sobre a tabela dizendo quantas colunas o arquivo parece ter e oferecendo a leitura tolerante: ela lê linha a linha sem exigir colunas iguais — é a mesma leitura que a busca e a IA usam — e filtra, ordena e tem gráfico, tabela dinâmica e Área de análise — só não tem SQL livre. Para um texto que ainda não está salvo, ou com um delimitador escolhido à mão, use Exibir → Visualizar como arquivo delimitado….

CSV exportado abre direto no Excel. O Exportar CSV das Tarefas, da planilha e da Tabela personalizada grava com o separador de lista do seu idioma — ponto e vírgula onde a vírgula é o decimal — e com a marca UTF-8 de que o Excel precisa para ler os acentos: o arquivo abre em colunas, sem assistente de importação. O Copiar como → CSV continua com vírgula, que é o que se cola num script ou numa mensagem; a exportação do resultado SQL deixa escolher o separador.

Agrupar pelo padrão. Numa coluna de datas ou de códigos os valores distintos são quase tantos quanto as linhas, e agrupar por eles não diz nada. A máscara de padrão troca cada letra por A e cada algarismo por N, deixando o resto: 2027/10/10 vira NNNN/NN/NN. Assim milhões de linhas viram dois ou três formatos — e o que foge deles é exatamente o dado sujo (a data que veio 10-10-2027, o código sem o prefixo). No gráfico é a caixa Padrão ao lado do eixo X; na tabela dinâmica, o botão direito sobre a pílula de um campo (é por campo, para cruzar o formato de um código com uma dimensão normal); e no painel Qualidade os padrões mais comuns aparecem sob os valores mais comuns de cada coluna. A conta roda no banco. Em SQLite e no ODBC genérico a opção fica desabilitada com o motivo: falta a função de texto que a máscara usa.