PythonでデータフレームをHTMLファイルにエクスポートする方法

pandasのデータフレームをHTML形式のファイルとして出力したい場面は多くあります。例えば、Webページに表形式のデータを掲載したいときや、レポート作成時にそのままHTMLへ組み込みたいときなどが挙げられます。

ここでは、あらかじめ保存しておいた pandas.csv ファイルを読み込み、それをHTML形式にエクスポートする方法を解説します。

解決手順

以下の手順に従って実装していきます。

1. CSVファイルを読み込む

read_csv メソッドを使って、CSVファイルをデータフレームとして読み込みます。

df = pd.read_csv('pandas.csv')

2. 書き込みモードでHTMLファイルを作成する

ファイルオブジェクトを使い、書き込みモード（'w'）で新しい pandas.html ファイルを作成します。

f = open('pandas.html','w')

3. データフレームをHTMLに変換する

to_html() メソッドを使用して、データフレームをHTML形式の文字列に変換し、結果を変数に格納します。

result = df.to_html()

4. データを書き込んでファイルを閉じる

ファイルオブジェクトを使って変換結果をすべて書き込み、最後にファイルを閉じます。

f.write(result)
f.close()

実装例

実際のコード全体は以下のようになります。

import pandas as pd
df = pd.read_csv('pandas.csv')
print(df)
f = open('pandas.html','w')
result = df.to_html()
f.write(result)
f.close()

出力結果

このコードを実行すると、pandas.html ファイルが生成され、中身は以下のようなHTMLテーブルになっています。

<table border="1" class="dataframe">
    <thead>
        <tr style="text-align: right;">
            <th></th>
            <th>Id</th>
            <th>Data</th>
        </tr>
    </thead>
    <tbody>
        <tr>
            <th>0</th>
            <td>1</td>
            <td>11</td>
        </tr>
        <tr>
            <th>1</th>
            <td>2</td>
            <td>22</td>
        </tr>
        <tr>
            <th>2</th>
            <td>3</td>
            <td>33</td>
        </tr>
        <tr>
            <th>3</th>
            <td>4</td>
            <td>44</td>
        </tr>
        <tr>
            <th>4</th>
            <td>5</td>
            <td>55</td>
        </tr>
    </tbody>
</table>

補足：with文を使ったより安全な書き方

上記の例では f.close() を明示的に呼び出していますが、with 文を使うと処理終了後に自動的にファイルが閉じられるため、より安全で簡潔なコードになります。

import pandas as pd

df = pd.read_csv('pandas.csv')

with open('pandas.html', 'w', encoding='utf-8') as f:
    f.write(df.to_html())

また、日本語などのマルチバイト文字を含むデータを扱う場合は、encoding='utf-8' を指定しておくと文字化けを防げます。必要に応じて to_html() の引数（index=False でインデックス非表示など）も活用すると、出力形式を柔軟にカスタマイズできます。