【よく分かる】xlwingsでExcelを制御しよう by Python

当ページのリンクには広告が含まれています。

PythonからExcelブックに対して、データを読み書きしたり罫線やフォントを設定するライブラリはいくつかありますが、今回は Anaconda に標準搭載されている xlwings 使い方 について、使い方を解説したいと思います。

他のサイトの記事には断片的な解説が多いので、はじめてxlwingsを使う方は色々なサイトから情報を集めなければなりません。

この記事では、そのような事が無いよう、実用的に使う上で知っておくべき知識を一通り網羅しています。

目次

xlwings の特徴

PytonからEXCELファイルを読み書きする方法として、openpyxl ライブラリ がありますが、両者には以下の違いがあります。

比較項目 xlwings openpyxl
動作環境 Windows/MacOS Windows/MacOS/Linux
Excelのインストール必要不要
サポートしているファイル形式Excelがサポートする形式全てExcel 2010以降のxlsx/xlsm/xltx/xltm
Excelとの互換性
Excelマクロの呼び出し ×
ExcelからPython関数呼び出し×
処理速度 遅い 速い
Python対応バージョン Python 3.6以上 Python 3.6以上
ライセンス OSS
(BSD3条項ライセンス)
OSS
(MIT Expat License)
公式サイトxlwingsクイックスタートopenpyxlチュートリアル

比較表の中で一番気になるのが、openpyxl における互換性の問題です。

  • openpyxl が対応していない計算式が存在する。
  • 対応していない計算式を含むブックを読み込んで保存すると、その計算式が消える
  • 行挿入の挙動がEXCELと異なる(属性が引き継がれず、下段の計算式が狂う)

上記の様に、計算式に関する部分は欠落する可能性があるため、特に第三者が作成したEXCELブックにデータを流し込むようなケースでは、予期せぬ事態に発展する可能性があります。

一方、速度については openpyxl の方が圧倒的に早い(8倍程度)という書き込みがありましたが、これは大量データをループ処理で書き込んだ場合です。

幸いなことに、xlwings では range メソッドを使った一括書き込みが可能で、これを使えば openpyxl と遜色が無いくらい速くなります。

上記のことから、Linuxで使う場合は openpyxl 一択になりますが、WindowsやMacOSで使うのであれば、xlwings が安心です。

あわせて読みたい
【よく分かる】xlwingsでExcelを制御しよう by Python PythonからExcelブックに対して、データを読み書きしたり罫線やフォントを設定するライブラリはいくつかありますが、今回は Anaconda に標準搭載されている xlwings 使...

インストール方法

xlwings は Anaconda でPythonをインストールすると標準でインストールされています。

もしインストールされていない場合は、以下の手順に従ってください。

Anaconda 又は Miniconda でPythonをインストールしている場合は

Python公式サイトからPython をインストールしている場合は

更に詳しい情報については、こちらの公式サイトに記載されています。

xlwings の使い方

xlwings を使うには import が必要です。

プログラムの先頭に下記の 1行を記述して下さい。

使い方は非常に簡単で、以下の手順でメソッドを呼び出せばExcelブックが作成できます。

xlwings の仕組みとExcelブックが削除できなくなった時の対処方

xw.Book() を実行するとExcelアプリケーションが起動し、以降の操作はそのExcelアプリケーションを通して実行されます。

そして、Close() を実行することでExcelアプリケーションが終了します。

xlwings はExcelと高い互換性がありますが、その理由はExcelアプリケーションそのものを使っているからです。

もし Close() をし忘れると起動したExcelがいつまでもタスクに残ったままになり、保存したExcelブックも掴まれたままになります。

以上の理由から、プログラムが何らかの原因で異常終了した場合、そのExcelブックは消せなくなります。

そんな場合は、タスクスケジューラ残っているExcelを削除することで、そのExcelブックも削除できるようになります。

Microsoft Excel の行をクリックし、DELキーを押すとタスクから削除可能です。

新規にExcelブックを作成するには

新規でExcelブックを作成する場合は、下記の手順になります。

Excelブックを新規作成した場合、「Sheet1」というシートが自動的に作成されています。

また、sheets.add() を実行すると、左側に新しいシートが追加されます。

下記は新規作成したExcelブックにシートを追加し、そのシートに値を書き込んでファイルに保存するサンプルプログラムです。

xw.App(visible=False) は、xlwings がExcelブックを開いた時に画面に表示されるのを防ぐためのものです。

デバッグ中は visible = True にしておくことで動画が画面で確認できるので便利ですが、本稼働で使う場合にいちいちExcelが表示されるとうっとおしいので、ここでは visible = False にしています。

上記のプログラムを実行すると、次のExcelブックが保存されます。

rangeメソッドの引数にはセル位置を指定しますが、データが2次元配列(ndarray、DataFrame含む)の場合は一覧形式で書き込んでくれます。

尚、DataFrameはカラムとインデックスを持っていますので、options を使ってインデックスは書き込まないようにしています。

セルの指定は、’A1’ の他、行番号と列番での指定が可能です。

セルの範囲を指定する場合 'A1:C7' という記述をします。

既存のExcelブックを開いて、中身を書き換えて保存するには

既存のExcelブックを開いて中身を編集する場合は、下記の手順になります。

下記は、前述のサンプルプログラム で作成したExcelブックを読み込み、シート1に転記するサンプル プログラム です。

シートは ws.sheets[0] のように番号で指定することも可能ですが、sheets.add() で追加したシートは左端に追加されていくため、書き込みたいシートが0番目ではい可能性があります。

そのため、あえてシート名を使って転記先のシートを指定しています。

上記のプログラムを実行すると、以下の結果になります。

セルの属性(背景色、罫線、フォントなど)を設定するには

セルに背景色、罫線、フォントなどの属性を指定するには、その範囲を range で指定し、そこに対して必要な属性を設定していきます。

api には様々なものが用意されていますので、詳しくはこちらの公式サイトをご確認下さい。

下記は、指定した範囲に属性を設定するサンプルソースです。

このプログラムを実行すると、下記の様になります。

設定している値が数値ばかりでマイナスの値も含まれていたり、色の指定は番号やRGBの数値だったりと、非常に分かり難い値を設定しなければなりません。

ただ、これは xlwings が悪いのではなく、Excelの仕様がこうだからです。

VBAでも同様のことができますが、VBAから属性を設定する時も、この値を使います。

あまりに分かり難いので Python 用の定数を作ってみました。

各行のコメントの位置がバラバラで見難いかもしれませんが、これは本サイトのフォントの問題なので、テキストエディタやVisual Studio Code などに張り付けると、ちゃんと揃っています。

セルに計算式を登録するには

セルに計算式を登録するには、下記の様に記述します。

このプログラムを実行した結果は以下の様になります。

B7のセルには、2+4+6+8=20が正しく表示されています。

グラフにアクセスするには

グラフはシートの中に配列で保持されており、charts プロパティで取得できます。

下記は先頭のグラフに対して、タイトルを変更した後で画像ファイルとしてサンプルです。

api は配列になっていますが、0ではなく1を指定します。

また、Export を export と記述した場合、そこでフリーズしてしまいますので、打ち間違いにはご注意下さい。

グラフに対しては、追加や削除などのメソッドが用意されていますので、詳しくは下記の公式サイトをご確認下さい。

Charts の説明(公式サイト)
Chart(個々のグラフ)の説明(公式サイト)

Excel側のマクロを呼び出すには

Excel側のマクロを呼び出すには、macroメソッドを使います。

詳しくは下記の記事に記載しているので、併せてご一読下さい。

まとめ

今回は xlwings を使った Excelブックの読み書きについて解説しました。

Excelをインストールしておく必要はありますが、Excelとの互換性を考えるなら、xlwings が一番使いやすいと言えます。

書き込みについては、For ループで単一セルに値を書き込むような処理だと時間が掛かりますが、range を使った一括書き込みの場合はかなり高速に処理してくれます。

PythonでExcelを編集したい場合は、xlwings もご検討ください。

この記事が皆さんのお役に立てれば幸いです。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

コメント

コメントする

目次