Encontrar valores distintos com NumPy
Nesta lição, você vai encontrar os valores distintos de um array NumPy e contar quantas vezes cada um aparece.
Introdução
O problema
Quais categorias aparecem em um conjunto de dados, e com que frequência? Respostas de pesquisas, códigos de produtos e rótulos precisam de uma tabela de frequência rápida antes da análise, e também para procurar erros de digitação ou valores inesperados.
Pense assim
Encontrar valores únicos com contagens é como separar um saco de miçangas coloridas em potes. Cada pote guarda uma cor, e você escreve no pote quantas miçangas há nele. Os potes ficam em ordem.
np.unique(values, ...)🥣 Um pote para cada valor distinto, em ordemreturn_counts=True🔢 Escreva quantas miçangas há em cada pote.tolist()🧾 Converta para números comuns do Pythondict(zip(...))📋 {1: 2, 2: 1, 3: 3}np.unique devolve os valores distintos de um array em ordem e, com return_counts=True, também quantas vezes cada valor aparece.
Pontos-chave
np.unique(values, return_counts=True)devolve dois arrays:uniqueecounts.uniqueguarda os valores distintos ordenados: 1, 2, 3.countsguarda quantas vezes cada um aparece: 2, 1, 3.unique.tolist()ecounts.tolist()transformam números do NumPy em números comuns do Python, então o dicionário aparece como{1: 2, 2: 1, 3: 3}.
Quando usar?
- Tabelas de frequência para categorias e rótulos.
- Verificar os dados atrás de valores inesperados ou escritos errado.
- Contar o tamanho das classes antes de treinar um modelo.
Quando não é preciso
- Listas comuns do Python:
collections.Counterdá as contagens sem NumPy. - Tabelas com várias colunas: o
value_counts()do pandas mantém os rótulos e ordena pela contagem.
Código de exemplo
import numpy as np
values = np.array([3, 1, 3, 2, 1, 3])
unique, counts = np.unique(values, return_counts=True)
print(dict(zip(unique.tolist(), counts.tolist())))
Resultado da execução
{1: 2, 2: 1, 3: 3}
Explicação do código
A função np.unique() retorna os valores distintos em ordem crescente. Com o parâmetro return_counts=True, ela também retorna um array com o número de ocorrências de cada valor. A função zip() junta os dois arrays, e dict() cria o resultado {1: 2, 2: 1, 3: 3}.
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.
- Mude o formato (shape) e o tipo de dado (dtype) do array de entrada.
- Teste com números negativos, decimais e valores ausentes.
- Aplique a mesma operação em um array maior, com mais dimensões, e meça o tempo.
Erros comuns
Imprimir números do NumPy em um dicionário
No NumPy 2, as chaves e valores aparecem como np.int64(1) em vez de 1.
print(dict(zip(unique, counts)))
print(dict(zip(unique.tolist(), counts.tolist())))
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.
- Tokenizador de palavras e vocabulário Divida um texto em palavras minúsculas e construa um vocabulário ordenado por frequência, o primeiro passo de todo modelo de linguagem. Fácil
- Remover Duplicatas Mantenha apenas a primeira ocorrência de cada valor. Fácil