O que é a pro­pri­e­dade Pandas iloc[] em Python?

A pro­pri­e­dade iloc[] no Python Pandas é usada para se­le­ci­o­nar os dados de um DataFrame a partir de índices. Esse recurso permite vi­su­a­li­zar linhas e colunas es­pe­cí­fi­cas do DataFrame.

Qual é a sintaxe da pro­pri­e­dade Pandas iloc[]?

A pro­pri­e­dade Pandas iloc[] usa números inteiros para es­pe­ci­fi­car quais elementos do DataFrame devem ser se­le­ci­o­na­dos. A sintaxe de Pandas DataFrame.iloc() é esta:

DataFrame.iloc[selection]

Você pode passar à pro­pri­e­dade Pandas iloc[] um único número inteiro, uma lista em Python de números inteiros, o método slice ou uma tupla em Python com índices de linhas e colunas.

Como usar a pro­pri­e­dade Pandas DataFrame.iloc[]

O com­por­ta­mento da pro­pri­e­dade Pandas iloc[] muda de acordo com o valor que é passado a ela. Apre­sen­ta­mos di­fe­ren­tes exemplos a seguir que ilustram seus diversos com­por­ta­men­tos.

Se­le­ci­o­nar uma linha

Primeiro, vamos criar um DataFrame contendo nomes de pessoas, suas idades e as cidades nas quais elas moram:

import pandas as pd
# Exemplo de DataFrame
data = {'Nome': ['Alice', 'Carlos', 'Daniela', 'Caio'],
    'Idade': [28, 24, 22, 32],
    'Cidade': ['Salvador', 'Rio de Janeiro', 'Belo Horizonte', 'Curitiba']}
df = pd.DataFrame(data)
print(df)

O DataFrame ficará assim:

Nome  Idade        	Cidade
0   Alice   28    		Salvador
1   Carlos   24  		Rio de Janeiro
2   Daniela  22    	Belo Horizonte
3   Caio      32     	Curitiba

Usando a pro­pri­e­dade Pandas iloc[], você consegue se­le­ci­o­nar qualquer linha ao passar seu res­pec­tivo índice:

# Selecionar a primeira linha (índice 0)
result = df.iloc[0]
print(result)

Neste exemplo, se­le­ci­o­na­mos a primeira linha (índice 0). O resultado apre­sen­tará as in­for­ma­ções de Alice:

Nome       Alice
Idade           28
Cidade     Salvador
Nome: 0, dtype: object

Se­le­ci­o­nar uma linha e uma coluna

Se você deseja es­pe­ci­fi­car o índice de uma linha e de uma coluna, passe os res­pec­ti­vos valores à pro­pri­e­dade Pandas iloc[] separados por uma vírgula:

# Selecionar a primeira linha e a segunda coluna
result = df.iloc[0, 1]
print(result)

Usando o código acima, a pro­pri­e­dade Pandas iloc[] se­le­ci­o­nará a primeira linha (índice 0) e a segunda coluna (índice 1). O resultado informado será a idade de Alice (28).

Se­le­ci­o­nar múltiplas linhas e colunas com o método slice

Também é possível se­le­ci­o­nar múltiplas linhas e colunas si­mul­ta­ne­a­mente usando o método slice do Python. Lembre-se de que o índice inserido após o símbolo de dois pontos não será incluído na seleção.

# Selecionar as duas primeiras linhas e as duas primeiras colunas
result = df.iloc[0:2, 0:2]
print(result)

Este será o resultado gerado pelo código acima:

Nome  Idade
0  Alice      28
1  Carlos    24

Nesse caso, se­le­ci­o­na­mos as duas primeiras linhas (0:2) e as duas primeiras colunas. O DataFrame re­sul­tante inclui apenas os dados das linhas 0 e 1 e das colunas 0 e 1.

Se­le­ci­o­nar múltiplas linhas e colunas com listas

Você também pode usar listas em Python para se­le­ci­o­nar múltiplas linhas e colunas. A vantagem da uti­li­za­ção de listas é a pos­si­bi­li­dade de se­le­ci­o­nar partes do DataFrame que não são se­quen­ci­ais:

# Selecionar a primeira e a terceira linhas e a segunda e a terceira colunas
result = df.iloc[[0, 2], [1, 2]]
print(result)

Nesse caso, se­le­ci­o­na­mos a primeira e a terceira linhas ([0, 2]) e a segunda e a terceira colunas ([1, 2]), o que produzirá o seguinte resultado:

Idade      Cidade
0     28        Salvador
2     22     Belo Horizonte