Python Pandas - インデックス内のすべてのラベルが渡されたラベルより後の場合にNaNを返すasof()メソッドの使い方

Pandasのindex.asof()メソッドを使用すると、渡されたラベルと同じか、それより前の位置にある最も近いラベルをインデックスから取得できます。もしインデックス内のすべてのラベルが渡されたラベルよりも後ろにある場合には、NaNが返されます。

必要なライブラリのインポート

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

import pandas as pd

Pandasインデックスの作成

数値を要素として持つPandasインデックスを作成します。

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

インデックスの表示

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

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

asof()メソッドでラベルを取得する

インデックスからラベルを取得します。この例では引数として6を渡していますが、インデックス内の最小のラベルは10であるため、すべてのラベルが渡された値よりも後ろに存在します。そのため、戻り値はNaNになります。

print("\nGet the label from the index...\n", index.asof(6))

完全なコード例

以下に、ここまでの処理をまとめた完全なコードを示します。

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)

# インデックスからラベルを取得
# すべてのラベルが渡されたラベルより後ろの場合はNaNを返す
print("\nGet the label from the index...\n", index.asof(6))

出力結果

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

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

Number of elements in the index...
7

Get the label from the index...
nan

このように、asof(6)を呼び出した結果としてnanが出力されました。これは、インデックス内のすべてのラベル（10〜70）が渡されたラベル「6」よりも大きいためです。逆に、index.asof(35)のように渡せば、「35」以下で最も近いラベルである「30」が返される点も覚えておくと便利です。