Python・Pandas DataFrameでCSV読み込み時に列名を明示的に指定する方法

PandasでCSVファイルを読み込む際、元のファイルにヘッダー（列名）が含まれていないケースはよくあります。そのような場合、read_csv()メソッドのnamesパラメータを使えば、列名を明示的に指定できます。この記事では、具体的な手順をサンプルコードと実行結果とともに解説します。

namesパラメータによる列名の指定

read_csv()メソッドのnamesパラメータに列名のリストを渡すことで、ヘッダーを持たないCSVファイルに任意の列名を割り当てられます。例として、Microsoft Excelで開いた次のようなヘッダーなしのCSVファイルを想定します。

このファイルを読み込む際、namesパラメータに「Team」「Rank_Points」「Year」という3つの列名を指定します。

pd.read_csv("C:\\Users\\amit_\\Desktop\\TeamData.csv", names=['Team', 'Rank_Points', 'Year'])

完全なサンプルコード

以下は、ヘッダーなしで読み込んだ場合と、namesパラメータで列名を指定して読み込んだ場合を比較する完全なコードです。

import pandas as pd

# CSVファイルをPandas DataFrameとして読み込む（ヘッダーなし）
dataFrame = pd.read_csv("C:\\Users\\amit_\\Desktop\\TeamData.csv")
print("Reading the CSV file without headers...\n", dataFrame)

# namesパラメータでヘッダー（列名）を追加
dataFrame = pd.read_csv("C:\\Users\\amit_\\Desktop\\TeamData.csv", names=['Team', 'Rank_Points', 'Year'])

# 更新後のCSVを読み込んで表示
print("\nReading the CSV file after updating headers...\n", dataFrame)

実行結果

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

Reading the CSV file without headers...
    Australia   2500   2021
0  Bangladesh   1000   2021
1     England   2000   2021
2       India   3000   2021
3    Srilanka   1500   2021

Reading the CSV file after updating headers...
         Team   Rank_Points   Year
0   Australia          2500   2021
1  Bangladesh          1000   2021
2     England          2000   2021
3       India          3000   2021
4    Srilanka          1500   2021

ポイントのまとめ

• ヘッダーなしのCSVをそのまま読み込むと、先頭行のデータが誤って列名として扱われてしまいます。
• namesパラメータに列名のリストを渡すことで、正しい列名を明示的に設定できます。
• すでにヘッダーが存在するファイルの場合は、header=0と組み合わせることで既存のヘッダーを置き換えることも可能です。