Python PandasとXlsxWriterでExcelファイルを操作する方法

PythonのPandasは、データ分析向けのライブラリです。小規模から大規模なデータセットまで読み込み、フィルタリングや並べ替えなどの加工を行い、Excelをはじめとするさまざまな形式で出力することができます。

PandasがExcelファイルに書き込む際には、内部でXlsxWriterモジュールが利用されます。

XlsxWriterは、XLSX形式のファイルを作成するためのPythonモジュールです。テキスト・数値・数式を複数のワークシートに書き込めるほか、書式設定、画像の挿入、グラフ作成、ページ設定、オートフィルタ、条件付き書式など、多彩な機能をサポートしています。

サンプルコード：DataFrameを任意の位置に書き込む

以下の例では、4つのDataFrameを1つのワークシート上の異なる位置に書き込んでいます。startrowやstartcolパラメータを使うことで、出力開始位置（行・列）を自由に指定できます。

# pandasをインポート
import pandas as pd

# データからPandasのDataFrameを作成
df1 = pd.DataFrame({'Data': [11, 12, 13, 14]})
df2 = pd.DataFrame({'Data': [21, 22, 23, 24]})
df3 = pd.DataFrame({'Data': [31, 32, 33, 34]})
df4 = pd.DataFrame({'Data': [41, 42, 43, 44]})

# XlsxWriterをエンジンとして指定し、Excelライターオブジェクトを作成
writer = pd.ExcelWriter('pandas_positioning.xlsx', engine='xlsxwriter')

# DataFrameをワークシートに書き込み、配置を指定する
# デフォルトの位置はセルA1
df1.to_excel(writer, sheet_name='Sheet1')

# startcol=3 でD列から書き込み
df2.to_excel(writer, sheet_name='Sheet1', startcol=3)

# startrow=6 で7行目から書き込み
df3.to_excel(writer, sheet_name='Sheet1', startrow=6)

# ヘッダーとインデックスを省略して書き込むことも可能
df4.to_excel(writer, sheet_name='Sheet1', startrow=7, startcol=4,
             header=False, index=False)

# Excelライターオブジェクトを閉じて、Excelファイルを出力
writer.save()

注意点：save()メソッドの非推奨化

上記コードのwriter.save()は、pandas 1.0以降で非推奨となり、その後のバージョンでは削除されています。最新の環境では、代わりにwriter.close()を使用してください。こちらも呼び出し時にファイルへの書き込みが完了します。

# 新しいバージョンのpandasでの推奨される書き方
with pd.ExcelWriter('pandas_positioning.xlsx', engine='xlsxwriter') as writer:
    df1.to_excel(writer, sheet_name='Sheet1')
    df2.to_excel(writer, sheet_name='Sheet1', startcol=3)
    df3.to_excel(writer, sheet_name='Sheet1', startrow=6)
    df4.to_excel(writer, sheet_name='Sheet1', startrow=7, startcol=4,
                 header=False, index=False)

このようにwith文を使えば、ブロックを抜けた時点で自動的にファイルが保存され、コードもより安全で読みやすくなります。