HOWTO · Pandas

Pandas에서 특정 열이 주어진 조건을 만족하는 모든 행의 색인을 얻는 방법

간단한 인덱싱 연산, np.where() 함수 및 query() 메소드를 사용하여 Pandas에서 특정 열이 주어진 조건을 만족하는 모든 행의 인덱스를 얻을 수 있습니다.

이 페이지의 내용

Pandas 열의 조건을 만족하는 행을 찾으려면 불리언 인덱싱으로 행을 필터링한 뒤 결과 DataFrame의 .index를 확인하세요. 이 값은 행을 식별하는 인덱스 레이블이며 숫자로 된 행 위치와 다를 수 있습니다. np.where()를 사용하면 조건 배열에서 일치하는 위치를 구할 수 있고, DataFrame.query()를 사용하면 식으로 행을 필터링하면서 인덱스 레이블을 유지할 수 있습니다. 다음 단계에서 필요한 결과에 맞춰 선택하세요.

불리언 인덱싱으로 조건에 맞는 행의 인덱스 가져오기

df["Sales"] >= 300과 같은 비교식은 DataFrame의 행에 맞춰 정렬된 불리언 Series를 만듭니다. 이 Series를 df[...]에 넣어 조건에 맞는 행만 남긴 다음 .index에 접근하세요. .tolist()를 호출하면 인덱스를 일반 Python 리스트로 바꿀 수 있어 다른 함수에 전달하거나 화면에 표시하기 편리합니다.

다음 예제를 실행해 보세요.

이 섹션의 코드와 표시되는 레이블 또는 출력은 영어로 유지됩니다.

import pandas as pd

df = pd.DataFrame(
    {"Sales": [200, 300, 400, 200, 300, 300]},
    index=[10, 11, 12, 13, 14, 15],
)
mask = df["Sales"] >= 300
matching_rows = df[mask]
print(mask.tolist())
print(matching_rows)
print(matching_rows.index.tolist())

마스크는 Sales 값이 300 이상인 행을 표시합니다. matching_rows.index에는 남은 행의 레이블이 들어 있으며, 여기에 .tolist()를 적용하면 레이블 목록을 얻습니다. 이 예제에서는 레이블과 행 위치가 의도적으로 다르게 설정되어 있어 두 값의 차이를 확인할 수 있습니다. 코드에 쓰인 Sales 열 이름은 예제 안에서 영어 그대로 표시됩니다.

인덱스 레이블과 행 위치 이해하기

인덱스 레이블은 DataFrame의 인덱스에 저장된 행 식별자입니다. 행 위치는 현재 행 순서에서 0부터 세는 오프셋입니다. 기본 RangeIndex를 사용하면 레이블이 행 위치처럼 보이는 경우가 많지만, 이는 편리하게 일치할 뿐 두 개념이 같다는 뜻은 아닙니다. DataFrame을 필터링해도 행 번호를 다시 매기지 않고 기존 레이블을 유지합니다. 행 식별자가 필요하면 .index를 사용하고, API가 현재 배열이나 행 순서에서의 오프셋을 요구하면 위치 결과를 사용하세요.

np.where()로 조건에 맞는 행 위치 가져오기

np.where()는 Pandas 메서드가 아니라 NumPy 함수입니다. 1차원 불리언 조건을 전달하면 조건이 참인 위치를 담은 배열이 포함된 튜플을 반환합니다. 첫 번째 튜플 요소를 [0]으로 선택하면 행 위치만 담긴 1차원 배열을 얻습니다. 이 값은 DataFrame의 인덱스 레이블이 아니라 불리언 배열에서의 위치이므로, 사용자 지정 인덱스를 사용하는 DataFrame에서는 레이블과 다를 수 있습니다.

이 섹션의 코드와 표시되는 레이블 또는 출력은 영어로 유지됩니다.

import numpy as np
import pandas as pd

df = pd.DataFrame({"Sales": [200, 300, 400, 200, 300, 300]}, index=[10, 11, 12, 13, 14, 15])
mask = df["Sales"] >= 300
positions = np.where(mask.to_numpy())[0]
print(positions.tolist())

조건에 맞는 위치가 필요할 때는 np.where(mask.to_numpy())[0]을 사용하세요. 전체 호출을 list(...)로 감싸면 튜플의 배열이 하나 들어 있는 리스트가 만들어집니다. 이는 위치만 나열한 평평한 리스트와 다릅니다. 인덱스 레이블이 필요하다면 필터링된 DataFrame의 .index를 사용하세요. 예제 코드의 Sales 열 이름은 영어 그대로 유지됩니다.

DataFrame.query()로 행을 필터링하고 인덱스 가져오기

DataFrame.query()는 열 이름을 기준으로 문자열 식을 평가하고, 조건에 맞는 행을 DataFrame으로 반환합니다. 결과의 .index를 확인하면 원래 레이블을 얻을 수 있으며, 리스트가 필요하면 .tolist()를 사용하세요. 식의 열 이름과 비교 조건이 DataFrame에 맞는지 확인하세요. 여기서는 Sales 값이 300인 행을 선택합니다.

이 섹션의 코드와 표시되는 레이블 또는 출력은 영어로 유지됩니다.

import pandas as pd

df = pd.DataFrame({"Sales": [200, 300, 400, 200, 300, 300]}, index=[10, 11, 12, 13, 14, 15])
labels = df.query("Sales == 300").index.tolist()
print(labels)

식으로 행을 필터링해 레이블을 가져오려면 df.query("Sales == 300").index를 사용하세요. 불리언 조건에서 위치를 가져오려면 np.where(condition)[0]을 사용합니다. 조건에 맞는 행과 그 레이블을 모두 원할 때는 불리언 인덱싱이 직접적인 방법입니다. 세 방식은 서로 관련된 질문에 답하지만, 첫 번째와 세 번째 방식만 DataFrame의 인덱스 레이블을 반환합니다. 예제 코드의 Sales 열 이름은 영어 그대로 표시됩니다.