Pandas Series オブジェクトの name 属性：データフレームとの結合や名前の変更をわかりやすく解説

pandas.Series.name 属性は、Series オブジェクトの名前を設定または取得するために使用されます。名前は、Series オブジェクトを識別したり、データフレームに結合したりする際に役立ちます。

設定

Series.name 属性は、文字列を直接代入するか、name 引数を使用して設定できます。

# 文字列を直接代入
s = pd.Series([1, 2, 3], name="my_series")

# name 引数を使用
s = pd.Series([1, 2, 3], name="my_series")

取得

Series.name 属性にアクセスすると、Series オブジェクトの名前を取得できます。

s.name
# 'my_series'

例

以下の例は、Series.name 属性の使い方を示しています。

# データフレームを作成
df = pd.DataFrame({"a": [1, 2, 3], "b": [4, 5, 6]})

# Series オブジェクトを作成
s = df["a"]

# Series オブジェクトの名前を設定
s.name = "my_series"

# Series オブジェクトの名前を取得
s.name
# 'my_series'

# データフレームに Series オブジェクトを結合
df = df.join(s)

# 結果
#   a  b  my_series
# 0  1  4        1
# 1  2  5        2
# 2  3  6        3

補足

• Series.name 属性は、index 属性とは異なります。index 属性は、Series オブジェクトの各要素を識別するラベルの集合です。
• Series.name 属性は、DataFrame オブジェクトの列名にも使用できます。

pandas.Series.name 属性のサンプルコード

# 文字列を直接代入
s = pd.Series([1, 2, 3], name="my_series")

# name 引数を使用
s = pd.Series([1, 2, 3], name="my_series")

Series オブジェクトの名前を取得

s.name
# 'my_series'

データフレームに Series オブジェクトを結合

# データフレームを作成
df = pd.DataFrame({"a": [1, 2, 3], "b": [4, 5, 6]})

# Series オブジェクトを作成
s = df["a"]

# Series オブジェクトの名前を設定
s.name = "my_series"

# データフレームに Series オブジェクトを結合
df = df.join(s)

# 結果
#   a  b  my_series
# 0  1  4        1
# 1  2  5        2
# 2  3  6        3

Series オブジェクトの名前を変更

# Series オブジェクトの名前を変更
s.name = "new_name"

# 結果
s.name
# 'new_name'

Series オブジェクトの名前を削除

# Series オブジェクトの名前を削除
s.name = None

# 結果
s.name
# None

Series オブジェクトの名前を使ってデータフレームの列を選択

# データフレームを作成
df = pd.DataFrame({"a": [1, 2, 3], "b": [4, 5, 6], "c": [7, 8, 9]})

# Series オブジェクトの名前を使って列を選択
df["my_series"]

# 結果
# 0    1
# 1    2
# 2    3

Series オブジェクトの名前を使ってデータフレームの列を削除

# Series オブジェクトの名前を使って列を削除
del df["my_series"]

# 結果
#   a  b
# 0  1  4
# 1  2  5
# 2  3  6

これらのサンプルコードは、pandas.Series.name 属性の使い方を理解するのに役立ちます。

pandas.Series.name 属性の代替方法

rename() メソッドを使用して、Series オブジェクトの名前を変更できます。

# Series オブジェクトを作成
s = pd.Series([1, 2, 3])

# Series オブジェクトの名前を変更
s = s.rename("my_series")

# 結果
s.name
# 'my_series'

df.columns 属性

DataFrame オブジェクトの columns 属性を使用して、Series オブジェクトの名前を設定または取得できます。

# データフレームを作成
df = pd.DataFrame({"a": [1, 2, 3], "b": [4, 5, 6]})

# Series オブジェクトの名前を設定
df.columns = ["my_series", "b"]

# 結果
df.columns
# Index(['my_series', 'b'], dtype='object')

# Series オブジェクトの名前を取得
df["my_series"].name
# 'my_series'

loc 属性を使用して、Series オブジェクトの名前で要素にアクセスできます。

# Series オブジェクトを作成
s = pd.Series([1, 2, 3], name="my_series")

# Series オブジェクトの名前で要素にアクセス
s.loc["my_series"]
# 1

これらの方法は、pandas.Series.name 属性の代替として使用できます。