Python Pandas – 要求されたラベルの整数位置を取得し、完全一致がない場合に最も近いインデックス値を見つける方法

要求されたラベルの整数位置（integer location）を取得し、完全に一致する値が存在しない場合には最も近いインデックス値の位置を見つけたいときは、index.get_loc() メソッドを使用します。その際、method パラメータの値を "nearest" に設定することで、近い値を自動的に検索できます。

基本的な使い方

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

import pandas as pd

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

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

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

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

完全一致する値が存在しない場合に、最も近いインデックス値の位置を取得します。get_loc() の method パラメータに "nearest" を指定するのがポイントです。以下の例では、存在しない値「58」に対して最も近いインデックスの位置が返されます。

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

サンプルコード

以下は実際に動作するコード例です。

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 パラメータで "nearest" を設定
print("\nGet the location of the nearest index if no exact match...\n", index.get_loc(58, method="nearest"))

実行結果

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

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 nearest index if no exact match...
5

解説

実行結果から分かるように、get_loc(20) は位置「1」、get_loc(50) は位置「4」を返します。一方、インデックスに存在しない「58」を method="nearest" 付きで検索すると、「60」という最も近い値の位置である「5」が返されます。このように、get_loc() と method パラメータを組み合わせることで、正確なラベルが不明なデータでも柔軟にインデックス位置を特定でき、時系列データや数値データの検索処理において非常に便利です。