Python Pandas：get_loc()で要求ラベルの整数位置を取得し、完全一致しない場合は直前のインデックス値を返す方法

要求されたラベルの整数位置（integer location）を取得し、完全一致するラベルが存在しない場合には直前のインデックス値の位置を見つけるには、index.get_loc()メソッドを使用します。その際、methodパラメータにffill（forward fill／前方参照）を設定します。

まず、必要なライブラリをインポートします。

import pandas as pd

Pandasインデックスを作成します。

index = pd.Index([10, 20, 30, 40, 50, 60, 70])

作成したPandasインデックスを表示します。

print("Pandas Index...\n",index)

完全一致しない場合に直前のインデックスの位置を取得します。get_loc()の「method」パラメータに「ffill」を設定することで、指定した値がインデックスに存在しないときでも、それより小さい最も近い値の位置が返されます。

print("\nGet the location of the previous index if no exact match...\n", index.get_loc(45, method="ffill"))

例

以下がコード全体です。

import pandas as pd

# Pandasインデックスを作成
index = pd.Index([10, 20, 30, 40, 50, 60, 70])

# Pandasインデックスを表示
print("Pandas Index...\n",index)

# インデックス内の要素数を返す
print("\nNumber of elements in the index...\n",index.size)

# 指定したラベルから整数位置を取得
print("\nDisplay integer location from given index...\n",index.get_loc(20))
print("\nDisplay integer location from given index...\n",index.get_loc(50))

# 完全一致しない場合に直前のインデックスの位置を取得
# get_loc()の「method」パラメータに「ffill」を設定
print("\nGet the location of the previous index if no exact match...\n", index.get_loc(45, method="ffill"))

出力

上記のコードを実行すると、次のような出力が得られます。

Pandas Index...
Int64Index([10, 20, 30, 40, 50, 60, 70], dtype='int64')

Number of elements in the index...
7

Display integer location from given index...
1

Display integer location from given index...
4

Get the location of the previous index if no exact match...
3

解説

この例では、インデックスには 45 という値は存在しません。しかし method="ffill" を指定しているため、45 より小さい最も近い値である 40 の整数位置 3 が返されます。なお、get_loc(20) や get_loc(50) のように完全一致するラベルを指定した場合は、それぞれの位置 1 と 4 がそのまま返されます。この機能は、時系列データなどで特定の時点に対応するデータが存在しない場合に、直前の有効なデータ位置を取得したい場面で特に便利です。