A função DataFrame.any() da bi­bli­o­teca Python Pandas é utilizada para de­ter­mi­nar se pelo menos um valor num DataFrame do Pandas é avaliado como True ao longo de um eixo es­pe­cí­fico.

Sintaxe de any() em Pandas

A sintaxe básica da função any() no Pandas não é com­pli­cada e é a seguinte:

DataFrame.any(axis=0, bool_only=None, skipna=True)
python
Nota

O equi­va­lente a DataFrame.any() na popular bi­bli­o­teca Python numpy é numpy.any() e funciona de maneira se­me­lhante.

Pa­râ­me­tros re­le­van­tes

A função aceita vários pa­râ­me­tros:

Parâmetro Descrição Valor padrão
axis Determina se o método é aplicado ao longo das linhas (0 ou índice) ou colunas (1 ou colunas) 0
skipna Indica se os valores NaN devem ser omitidos True
bool_only Se for True, apenas as colunas booleanas são con­si­de­ra­das False

Uti­li­za­ção de DataFrame.any() em Pandas

Exemplo 1: Verificar se há valores True em alguma linha

O uso mais clássico da função any() do Pandas é verificar se há algum valor numa linha que seja avaliado como True. Isso pode ser útil quando é ne­ces­sá­rio verificar condições.

import pandas as pd
# Definición de un DataFrame con tres columnas y tres filas
data = {
    'A': [0, 0, 0],
    'B': [True, False, False],
    'C': [False, False, False]
}
df = pd.DataFrame(data)
# Uso de la función any() para comprobar si hay al menos un valor verdadero en las filas
result = df.any(axis=0)
print(result)
python

No exemplo de código anterior, DataFrame.any() do Pandas retorna uma série que indica que apenas na coluna B há pelo menos um valor que é avaliado como True. O resultado é o seguinte:

A    False
B    True
C    False
dtype: bool

Exemplo 2: Verificar se há valores True em alguma coluna

De forma análoga ao primeiro exemplo, também podemos verificar se há pelo menos um valor True em alguma coluna passando axis=1 como parâmetro:

result = df.any(axis=1)
print(result)
python

O resultado é o seguinte e mostra que apenas na primeira linha há um valor que é avaliado como True:

0     True
1    False
2    False
dtype: bool
Nota

Não se esqueça que, em in­for­má­tica, a numeração começa sempre em 0.

Ir para o menu principal