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() で変換するとラベルのリストになります。この例ではラベルと行位置を意図的に異なる値にしているため、その違いを確認できます。

インデックスラベルと行位置の違いを理解する

インデックスラベルは、DataFrame のインデックスに格納された識別子です。行位置は、現在の行順におけるゼロ始まりのオフセットです。既定の RangeIndex ではラベルが行位置のように見えることがありますが、それは便宜上たまたま一致しているだけです。DataFrame を絞り込んでも行には番号が振り直されず、元のラベルが保たれます。識別子が必要なら .index を使い、API が現在の配列や行順に対するオフセットを求める場合は位置の結果を使ってください。

np.where() で条件に一致する行位置を取得する

np.where() は Pandas のメソッドではなく、NumPy の関数です。1次元のブール条件を渡すと、条件が True である位置の配列を含むタプルを返します。[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 を使ってください。

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] を使います。該当する行とそのラベルの両方が必要な場合は、ブールインデックス参照が直接的な方法です。3つの方法は関連する問いに答えますが、DataFrame のインデックスラベルを返すのは1つ目と3つ目だけです。