Executar pandas online

Agrupar dados com groupby no pandas

Nesta lição, você vai agrupar as linhas de um DataFrame por uma coluna e calcular a média de cada grupo com groupby().

  • Intermediário
  • 2 min de leitura
  • 1 exemplo executável

Introdução

O problema

"Qual é a nota média por equipe?" "Total de vendas por mês?" Responder a isso percorrendo as linhas e mantendo um dicionário de totais é fácil de errar. groupby faz a divisão e o resumo por você.

Pense assim

groupby é como separar recibos em envelopes por loja, somar cada envelope e escrever os totais em uma folha de resumo. Divida em envelopes, calcule por envelope, junte os resultados.

Dos envelopes de recibos ao código
groupby("team")✉️ Um envelope por equipe
["score"]🧾 Olhe a nota em cada recibo
.mean()🧮 Tire a média de cada envelope
.reset_index()📄 Escreva os resultados em uma folha
Dividir, aplicar, combinar.
Em uma frase

groupby divide as linhas de um DataFrame em grupos por uma ou mais colunas, aplica um cálculo a cada grupo e combina os resultados.

Pontos-chave

  1. results.groupby("team") divide as linhas entre a equipe A e a equipe B.
  2. ["score"].mean() tira a média das notas dentro de cada equipe.
  3. As duas equipes têm média 85.0 aqui.
  4. reset_index() transforma os rótulos das equipes de volta em uma coluna normal.

Quando usar?

  • Resumos por categoria: média por turma, total por mês, contagem por país.
  • Comparar grupos lado a lado.
  • Montar relatórios e atributos (features) para análise.

Quando não é preciso

  • Um resumo com categorias tanto nas linhas quanto nas colunas: uma tabela dinâmica é mais fácil de ler.
  • Um único número geral: chame .mean() diretamente na coluna.

Código de exemplo

Executar código →
main.py
import pandas as pd

results = pd.DataFrame({
    "team": ["A", "A", "B", "B"],
    "score": [80, 90, 70, 100],
})

averages = results.groupby("team")["score"].mean().reset_index()
print(averages)
Gerar um botão Run para este exemplo

Resultado da execução

team  score
0    A   85.0
1    B   85.0

Explicação do código

A instrução results.groupby("team") divide as linhas nos grupos A e B. Em seguida, ["score"].mean() calcula a nota média de cada grupo, que é 85.0 nos dois casos. O resultado usa o nome do time como índice, então reset_index() transforma team de volta em uma coluna comum do DataFrame.

Altere os valores e execute o programa no compilador Python online CodeUtility sem instalar Python.

Exercícios práticos

Tente modificar o código seguindo as sugestões abaixo. Mudar o código e observar o resultado ajuda você a entender muito mais do que só ler.

  1. Adicione linhas, colunas e alguns valores ausentes aos dados de exemplo.
  2. Combine filtro, ordenação e groupby para montar um pequeno relatório.
  3. Leia um arquivo de dados real, confira o tipo de cada coluna e trate os valores inválidos.
Executar no compilador Python →

Erros comuns

Esquecer de escolher uma coluna

Sem uma coluna, mean() é aplicado a todas as colunas, o que falha ou surpreende com colunas de texto.

Problema
results.groupby("team").mean()
Correção
results.groupby("team")["score"].mean()

Terminou esta lição?

Marque como aprendida para acompanhar seu progresso.

Pratique com um desafio

Use o conteúdo desta lição para resolver um problema real. Cada desafio roda no navegador, com testes instantâneos e uma revisão por IA.

Todos os desafios