Executar NumPy online

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.

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

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.

Dos potes de miçangas ao código
np.unique(values, ...)🥣 Um pote para cada valor distinto, em ordem
return_counts=True🔢 Escreva quantas miçangas há em cada pote
.tolist()🧾 Converta para números comuns do Python
dict(zip(...))📋 {1: 2, 2: 1, 3: 3}
Os valores distintos e quantas vezes cada um aparece.
Em uma frase

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

  1. np.unique(values, return_counts=True) devolve dois arrays: unique e counts.
  2. unique guarda os valores distintos ordenados: 1, 2, 3.
  3. counts guarda quantas vezes cada um aparece: 2, 1, 3.
  4. unique.tolist() e counts.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.Counter dá 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

Executar código →
main.py
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())))
Gerar um botão Run para este exemplo

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.

  1. Mude o formato (shape) e o tipo de dado (dtype) do array de entrada.
  2. Teste com números negativos, decimais e valores ausentes.
  3. Aplique a mesma operação em um array maior, com mais dimensões, e meça o tempo.
Executar no compilador Python →

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.

Problema
print(dict(zip(unique, counts)))
Correção
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.

Todos os desafios