Python Pandas - MultiIndexでレベルの名前を取得する方法

MultiIndexの各レベルの名前を取得するには、PandasのMultiIndex.namesプロパティを使用します。まず、必要なライブラリをインポートしましょう。

import pandas as pd

MultiIndexとは、pandasオブジェクトで使用できる多階層（階層的）なインデックスオブジェクトのことです。まずは配列を作成します。

arrays = [[1, 2, 3, 4, 5], ['John', 'Tim', 'Jacob', 'Chris', 'Keiron']]

namesパラメータを指定すると、各インデックスレベルに名前を設定できます。そして、from_arrays()メソッドを使ってMultiIndexを作成します。

multiIndex = pd.MultiIndex.from_arrays(arrays, names=('ranks', 'student'))

MultiIndexの各レベルの名前を取得するには、以下のように記述します。

print("\nMultiIndexのレベルの名前...\n", multiIndex.names)

サンプルコード

以下が完全なコード例です。

import pandas as pd

# MultiIndexは、pandasオブジェクト用の多階層（階層的）なインデックスオブジェクトです
# 配列を作成
arrays = [[1, 2, 3, 4, 5], ['John', 'Tim', 'Jacob', 'Chris', 'Keiron']]

# "names"パラメータで各インデックスレベルに名前を設定
# from_arrays()を使ってMultiIndexを作成
multiIndex = pd.MultiIndex.from_arrays(arrays, names=('ranks', 'student'))

# MultiIndexを表示
print("The Multi-index...\n", multiIndex)

# MultiIndexのレベルの名前を取得
print("\nMultiIndexのレベルの名前...\n", multiIndex.names)

# MultiIndexのレベルを取得
print("\nMultiIndexのレベル...\n", multiIndex.levels)

出力結果

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

The Multi-index...
MultiIndex([(1, 'John'),
   (2, 'Tim'),
   (3, 'Jacob'),
   (4, 'Chris'),
   (5, 'Keiron')],
   names=['ranks', 'student'])

MultiIndexのレベルの名前...
['ranks', 'student']

MultiIndexのレベル...
[[1, 2, 3, 4, 5], ['Chris', 'Jacob', 'John', 'Keiron', 'Tim']]

補足：namesプロパティとset_names()メソッド

multiIndex.namesは読み取りだけでなく、後から名前を変更することも可能です。既存のMultiIndexに対して名前を設定し直したい場合は、set_names()メソッドが便利です。

# レベルの名前を後から変更する例
new_multiIndex = multiIndex.set_names(['順位', '生徒名'])
print(new_multiIndex.names)  # FrozenList(['順位', '生徒名'])

このように、namesプロパティを使えばMultiIndexの構造を把握しやすくなり、データ分析時に特定のレベルへアクセスする際にも役立ちます。