Python Pandas – インデクサーを計算し、完全一致がない場合に最も近いインデックス値を取得する方法

Pandasでインデクサーを計算し、検索対象の値がインデックスに完全一致しない場合に、最も近いインデックス値を自動的に取得したい場面はよくあります。そのような場合は、index.get_indexer()メソッドを使用し、methodパラメータに"nearest"を指定します。

通常のget_indexer()では、一致しない値に対して-1が返されますが、method="nearest"を指定することで、距離が最も近い要素のインデックス位置が返されるようになります。

基本的な使い方

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

import pandas as pd

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

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

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

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

get_indexer()を使ってインデクサーを計算します。methodパラメータに"nearest"を設定すると、完全一致する値が存在しない場合でも、最も近いインデックス値が返されます。

print("\nGet the indexes...\n", index.get_indexer([30, 25, 58, 50, 69], 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)

# get_indexer()でインデクサーを計算
# method="nearest"により、完全一致がない場合は最も近い値のインデックスを返す
print("\nGet the indexes...\n", index.get_indexer([30, 25, 58, 50, 69], method="nearest"))

実行結果

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

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

Number of elements in the index...
7

Get the indexes...
[2 2 5 4 6]

結果の解説

出力された配列 [2 2 5 4 6] の意味を確認してみましょう。

• 30 → インデックスに完全一致するため、そのまま位置 2 が返されます。
• 25 → 完全一致はありませんが、最も近いのは 30（位置 2）です。
• 58 → 最も近いのは 60（位置 5）です。
• 50 → 完全一致するため、位置 4 が返されます。
• 69 → 最も近いのは 70（位置 6）です。

このように、method="nearest"を活用すれば、データの照合やビニング処理などにおいて、近似値による柔軟なインデックス検索が簡単に実現できます。