pandas の DataFrame のカラム（列）名やインデックス（行）名を変更する (df.rename, df.add_prefix, df.add_suffix)

2023-09-04

pandas の DataFrame のカラム名やインデックス名を変更方法のまとめです。

カラム名を一括で置き換える (columns)

既存の DataFrame のカラム名（列名）を丸ごと置き換えるには、columns プロパティにカラム名のリストを代入します。

df.columns = ["列名1", "列名2", "列名3"]

この操作は、既存の DataFrame のカラム名を直接変更します。

# 全てのカラム名の先頭に X_ を付ける
f2 = df.add_prefix("X_")

# 全てのカラム名の末尾に _X を付ける
df2 = df.add_suffix("_X")

どちらの関数も、カラム名が変更された新しい DataFrame を返します。元の DataFrame のカラム名は変更されませんが、データ自体は同じメモリ上の値を参照しています。

カラム名（列名）の変更

df2 = df.rename(
    columns={
        "既存の列名1": "新しい列名1",
        "既存の列名2": "新しい列名2",
        "既存の列名3": "新しい列名3"
    }
)

インデックス名（行名）の変更

df2 = df.rename(
    index={
        "既存の行名1": "新しい行名1",
        "既存の行名2": "新しい行名2",
        "既存の行名3": "新しい行名3"
    }
)

DataFrame#rename() 関数は、カラム名やインデックス名が変更された新しい DataFrame を返します。元の DataFrame のカラム名やインデックス名は変更されませんが、データ自体は同じメモリ上の値を参照しています。

rename メソッドの columns 引数（あるいは index 引数）に名前の変換関数を指定すると、すべてのカラム名やインデックス名をまとめて置換できます。次の例では、変換関数として str.lower を指定しています。

全てのカラム名（列名）を小文字にする

df2 = df.rename(columns=str.lower)
df2 = df.rename(mapper=str.lower, axis=1)  # 同上

全てのインデックス名（行名）を小文字にする

df2 = df.rename(index=str.lower)
df2 = df.rename(mapper=str.lower, axis=0)  # 同上

次の例では、変換関数としてラムダ関数を指定しています。

デフォルトの行番号 (0, 1, 2, ...) から Y1, Y2, Y3, ... のような行名を生成

df2 = df.rename(index=lambda y: "Y{}".format(y + 1))

2023-09-04