# Obter valores únicos com Pandas unique()

Pode usar a função `unique()` da Biblioteca Python Pandas para obter os **valores únicos numa coluna de um DataFrame**, o que lhe permitirá obter uma visão geral dos diferentes valores dentro de um conjunto de dados.

## Sintaxe de `DataFrame[].unique()` em Pandas

A sintaxe básica para utilizar a função `unique()` do Pandas é simples, uma vez que esta função não aceita nenhum parâmetro adicional:

```python
DataFrame['column_name'].unique()
```

Tenha em atenção que, nos DataFrames do Pandas, a função `unique()` só pode ser aplicada a **uma coluna específica do DataFrame**. Portanto, deve especificar a coluna antes de a utilizar. A função `unique()` gera uma matriz NumPy com os valores únicos na ordem em que aparecem, ou seja, não realiza qualquer ordenação dos valores.

Nota Se já programa em Python há algum tempo, certamente já conhece **o equivalente do NumPy à função `unique()` do Pandas**. Recomendamos usar a variante do Pandas, pois será mais eficiente neste caso.

## Como usar o Pandas `unique()`

Para utilizar `unique()` nos [DataFrames do Pandas](https://www.ionos.com/pt-pt/digitalguide/paginas-web/desenvolvimento-web/dataframes-do-pandas-python/), deve especificar a coluna na qual deseja procurar valores únicos.

No exemplo a seguir, mostramos um DataFrame com informações sobre diferentes pessoas:

```python
import pandas as pd
# Crear un DataFrame de ejemplo
data = {
    'Nombre': ['Alicia', 'Juan', 'Carlos', 'David', 'Eduardo'],
    'Edad': [24, 27, 22, 32, 29],
    'Ciudad': ['Madrid', 'Barcelona', 'Madrid', 'Valencia', 'Barcelona']
}
df = pd.DataFrame(data)
print(df)
```

O DataFrame resultante seria o seguinte:

```none
Nombre    Edad       Ciudad
0    Alicia     24       Madrid
1     Juan     27    Barcelona
2    Carlos     22       Madrid
3    David     32     Valencia
4   Eduardo     29    Barcelona
```

Agora, se quiser identificar as cidades onde essas pessoas vivem, garantindo que **cada cidade seja listada apenas uma vez**, pode utilizar a função `unique()` do Pandas na coluna do DataFrame que contém as cidades:

```python
# Encontrar ciudades únicas
unique_cities = df['Ciudad'].unique()
print(unique_cities)
```

O resultado é uma **matriz NumPy que contém cada cidade apenas uma vez** e mostra que as pessoas da lista são provenientes de três cidades diferentes: Madrid, Barcelona e Valência.

```none
['Madrid' 'Barcelona' 'Valencia']
```


This is a markdown version of: [https://www.ionos.com/pt-pt/digitalguide/paginas-web/desenvolvimento-web/funcao-unique-para-dataframes-do-pandas-em-python/](https://www.ionos.com/pt-pt/digitalguide/paginas-web/desenvolvimento-web/funcao-unique-para-dataframes-do-pandas-em-python/) for AI/LLM consumption.