A função Pandas iloc() do Python

A função iloc[] da Bi­bli­o­teca Python Pandas serve para se­le­ci­o­nar dados dentro de um DataFrame do Pandas com base no seu índice. Desta forma, é possível vi­su­a­li­zar linhas e colunas es­pe­cí­fi­cas de um DataFrame de acordo com a sua posição.

Sintaxe da pro­pri­e­dade iloc[] do Pandas

A pro­pri­e­dade iloc[] do Pandas aceita inteiros que es­pe­ci­fi­cam quais elementos do DataFrame devem ser se­le­ci­o­na­dos. A sintaxe geral para DataFrame.iloc() é a seguinte:

DataFrame.iloc[selection]

Pode passar para iloc[] um único inteiro, uma lista de inteiros em Python, um objeto de corte (slice) ou uma tupla com índices de linhas e colunas como pa­râ­me­tros.

Uti­li­za­ção da pro­pri­e­dade Pandas DataFrame.iloc[]

O com­por­ta­mento do iloc[] de Pandas varia de acordo com o valor que você passa para essa pro­pri­e­dade. Você entenderá melhor com a ajuda dos seguintes exemplos práticos:

Seleção de uma linha es­pe­cí­fica

O primeiro passo consiste em criar um DataFrame. Neste exemplo, estão incluídos os nomes de várias pessoas, a sua idade e o seu local de re­si­dên­cia:

import pandas as pd
# Ejemplo de DataFrame
data = {'Nombre': ['Ana', 'Juan', 'Carla', 'David'],
    'Edad': [28, 24, 22, 32],
    'Ciudad': ['Barcelona', 'Madrid', 'Huelva', 'Castellón']}
df = pd.DataFrame(data)
print(df)

O DataFrame re­sul­tante tem a seguinte aparência:

Nombre  Edad    Ciudad
0     Ana    28    Barcelona
1     Juan     24    Madrid
2    Carla     22    Huelva
3    David     32    Castellón

Com a ajuda do iloc[], pode se­le­ci­o­nar qualquer linha. Para isso, basta indicar a linha desejada:

# Selección de la fila 0
result = df.iloc[0]
print(result)

Neste exemplo, seleciona-se a primeira linha (índice 0). O resultado mostra os dados de Ana:

Nombre       Ana
Edad         28
Ciudad    Barcelona
Name: 0, dtype: object

Seleção de uma linha e coluna es­pe­cí­fi­cas

Se, além do índice da linha, desejar es­pe­ci­fi­car o índice da coluna, pode passar ambos os índices para iloc[] como pa­râ­me­tros, separados por uma vírgula. Aqui está um exemplo:

# Selección de la fila 0 y la columna 1
result = df.iloc[0, 1]
print(result)

Com a chamada anterior à função iloc[] do Pandas, seleciona-se a primeira linha (índice 0) e a segunda coluna (índice 1). O resultado seria a idade de Ana: 28.

Seleção de várias linhas e colunas usando objetos de corte (slices)

O Pandas também permite se­le­ci­o­nar várias linhas e colunas ao mesmo tempo com os objetos de corte do Python. Tenha em atenção que o índice que aparece após os dois pontos não é incluído na seleção.

# Selección de las dos primeras filas y las dos primeras columnas
result = df.iloc[0:2, 0:2]
print(result)

O resultado do código anterior seria:

Nombre  Edad
0    Ana     28
1    Juan    24

Aqui, foram se­le­ci­o­na­das as duas primeiras linhas (0:2) e as duas primeiras colunas (0:2). O DataFrame re­sul­tante contém apenas os elementos cor­res­pon­den­tes.

Seleção de linhas e colunas es­pe­cí­fi­cas uti­li­zando listas

Como men­ci­o­ná­mos an­te­ri­or­mente, também pode se­le­ci­o­nar várias linhas e colunas uti­li­zando listas Python. Este método apresenta uma vantagem em relação aos an­te­ri­o­res, pois permite se­le­ci­o­nar áreas não contíguas do DataFrame.

# Selección de la primera y tercera fila, así como de la segunda y tercera columna
result = df.iloc[[0, 2], [1, 2]]
print(result)

Neste código, foram se­le­ci­o­na­das a primeira e a terceira linhas ([0, 2]) e a segunda e a terceira colunas ([1, 2]). O resultado é o seguinte:

Edad     Ciudad
0    28     Barcelona
2    22      Huelva