PythonでExcel操作！openpyxlのErrorBarクラスを使ってグラフの信頼性を高める方法

openpyxl

この記事では、Pythonのopenpyxlライブラリを使用して、Excelのグラフに「誤差範囲（エラーバー）」を追加する方法を初心者にも分かりやすく解説します。

研究データの可視化やビジネスレポート作成において、データのばらつきや不確かさを示すことは、グラフの信頼性を格段に向上させます。平均値だけでは見えないデータの背景を伝えることで、より説得力のある資料を作成できます。

この記事を最後まで読めば、openpyxlのErrorBarクラスの基本的な使い方から、少し応用的な設定方法までマスターし、データに基づいた客観的な示唆を得るためのグラフを自在に作成できるようになります。

なぜグラフに誤差範囲（ErrorBar）が必要なのか？

結論として、誤差範囲は、データの信頼性やばらつきを視覚的に伝え、より正確なデータ解釈を促すために不可欠です。

平均値だけをグラフにしても、そのデータがどれだけばらついているのかは分かりません。例えば、2つのグループのテストの平均点がどちらも70点だったとしても、片方は全員が65〜75点の間に固まっているのに対し、もう片方は50点から90点まで大きく散らばっているかもしれません。この「ばらつき」の情報を無視してしまうのが「平均値の罠」です。

誤差範囲は、このばらつきの度合い（標準偏差など）や、測定の不確かさ（標準誤差）、あるいは許容される誤差の範囲（固定値）を視覚的に示すためのものです。ビジネスや研究の現場で、データに基づいた誠実な議論を行う上で、この誤差範囲の表示は非常に重要な役割を果たします。

openpyxlでErrorBarを追加するための準備

結論として、openpyxlライブラリをインストールし、グラフの元となるExcelファイルとデータを用意します。

まずは、openpyxlがインストールされていない場合、以下のpipコマンドでインストールしてください。ターミナルやコマンドプロンプトで実行します。

pip install openpyxl

この記事では、月ごとの製品の平均売上と、そのばらつき（標準偏差）を示すデータを例として扱います。最終的に、このデータから誤差範囲付きの棒グラフを作成します。

グラフを作成するまでの大まかな流れは以下の通りです。

  1. Workbookオブジェクトを作成
  2. Worksheetオブジェクトを取得
  3. シートにデータを書き込む
  4. BarChartなどのChartオブジェクトを作成
  5. グラフのデータ範囲などを設定し、シートに追加する

この基本的な流れに、誤差範囲を追加する処理を加えていきます。

最もシンプル！固定値の誤差範囲（ErrorBar）を追加する方法

結論として、ErrorBarクラスをインスタンス化し、value属性に固定値を設定することで、簡単な誤差範囲を描画できます。

まずは、すべてのデータポイントに対して一律の誤差（例: ±10）を設定する最も基本的な方法を見ていきましょう。

openpyxl.chart.error_bar.ErrorBarクラスが誤差範囲そのものを表します。このオブジェクトを生成し、グラフオブジェクトのerrBars（複数形であることに注意）プロパティに追加することで、誤差範囲が表示されます。

サンプルコード：固定値の誤差範囲を持つ縦棒グラフを作成

import openpyxl
from openpyxl.chart import BarChart, Reference
from openpyxl.chart.error_bar import ErrorBar

# 1. WorkbookとWorksheetの準備
wb = openpyxl.Workbook()
ws = wb.active
ws.title = "FixedErrorBarSample"

# 2. サンプルデータの書き込み
rows = [
    ("Month", "Sales"),
    ("Jan", 150),
    ("Feb", 180),
    ("Mar", 165),
    ("Apr", 205),
]
for row in rows:
    ws.append(row)

# 3. グラフの作成
chart = BarChart()
chart.title = "月次売上レポート"
chart.y_axis.title = "売上"
chart.x_axis.title = "月"

# データの範囲を指定
data = Reference(ws, min_col=2, min_row=1, max_row=5)
categories = Reference(ws, min_col=1, min_row=2, max_row=5)
chart.add_data(data, titles_from_data=True)
chart.set_categories(categories)

# 4. 固定値のErrorBarを作成して追加
# 全てのデータポイントに ±10 の誤差範囲を追加
err_bar = ErrorBar(errValType='fixedVal', value=10)
chart.errBars = err_bar # グラフに誤差範囲をセット

# 5. シートにグラフを追加して保存
ws.add_chart(chart, "E2")
wb.save("FixedErrorBarChart.xlsx")

print("固定値の誤差範囲を持つグラフを作成しました。")

このコードを実行すると、各月の棒グラフに上下に10の長さを持つ誤差範囲が追加されたExcelファイルが生成されます。errValTypeに'fixedVal'を、valueに具体的な数値を指定するのがポイントです。

データに合わせて誤差範囲を変動させる方法

結論として、Excelシート上のセル範囲を数値ソースとして指定することで、データポイントごとに異なる誤差範囲を設定できます。

より実践的なケースでは、データごとにばらつきの大きさが異なるため、誤差範囲もそれに合わせて変えたい場合がほとんどです。openpyxlでは、誤差範囲の値を格納したセル範囲を参照させることで、これを実現できます。

標準偏差など、計算済みの値を誤差範囲として設定する

結論として、NumDataSourceとNumRefを使い、誤差範囲用のデータが格納されているセル範囲を参照します。

ここでは、各月の売上の標準偏差を計算し、それを誤差範囲としてグラフに設定する例を紹介します。

サンプルコード：各データポイントの標準偏差を誤差範囲として設定

import openpyxl
from openpyxl.chart import BarChart, Reference
from openpyxl.chart.error_bar import ErrorBar
from openpyxl.chart.data_source import NumDataSource, NumRef

# 1. WorkbookとWorksheetの準備
wb = openpyxl.Workbook()
ws = wb.active
ws.title = "CustomErrorBarSample"

# 2. サンプルデータの書き込み（標準偏差の列を追加）
rows = [
    ("Month", "Sales", "StdDev"),
    ("Jan", 150, 15),
    ("Feb", 180, 25),
    ("Mar", 165, 18),
    ("Apr", 205, 30),
]
for row in rows:
    ws.append(row)

# 3. グラフの作成
chart = BarChart()
chart.title = "月次売上レポート（標準偏差付き）"
chart.y_axis.title = "売上"
chart.x_axis.title = "月"

# データの範囲を指定
data = Reference(ws, min_col=2, min_row=1, max_row=5)
categories = Reference(ws, min_col=1, min_row=2, max_row=5)
chart.add_data(data, titles_from_data=True)
chart.set_categories(categories)

# 4. セル範囲を参照するErrorBarを作成
# C列の値を誤差範囲として使用
error_values = Reference(ws, min_col=3, min_row=2, max_row=5)
# NumDataSourceでラップする
num_data_source = NumDataSource(NumRef(error_values))

# plusとminusにデータソースを指定（同じ値を使用）
err_bar = ErrorBar(errValType='custom', plus=num_data_source, minus=num_data_source)
chart.errBars = err_bar

# 5. シートにグラフを追加して保存
ws.add_chart(chart, "E2")
wb.save("CustomErrorBarChart.xlsx")

print("データ連動の誤差範囲を持つグラフを作成しました。")

このコードでは、errValTypeを'custom'に設定し、plus（正方向の誤差）とminus（負方向の誤差）に、C列の標準偏差のデータ範囲から作成したNumDataSourceオブジェクトを指定しています。これにより、各棒グラフが自身の行に対応する標準偏差の値を誤差範囲として持つようになります。

よく使うエラーバーの種類と設定項目

ErrorBarオブジェクトには、他にも見た目や挙動を制御する便利なプロパティがあります。

  • errDir: 誤差範囲の方向を指定します。'y'（縦方向、デフォルト）、'x'（横方向）があります。
  • errValType: 誤差範囲の種類を指定します。'fixedVal'（固定値）、'percentage'（パーセンテージ）、'stdDev'（標準偏差）、そして'custom'（カスタム値）などがあります。
  • noEndCap: Trueに設定すると、誤差範囲の上下（左右）の端にある「T」字型のキャップ（ひげ）が非表示になります。

見た目を調整してグラフをより分かりやすく

結論として、ErrorBarのプロパティを変更することで、線の色や太さといった視覚的なスタイルをカスタマイズできます。

デフォルトの誤差範囲はシンプルな黒線ですが、spPr（ShapePropertiesの略）プロパティを通じて、線の色、太さ、種類などを自由に変更し、グラフの視認性を高めることができます。

サンプルコード：誤差範囲の線の色を赤色に、太さを変更する

以下のコードを、先ほどのCustomErrorBarChart.xlsxを作成するコードのchart.errBars = err_barの後に追加します。

# （...前略...）
# 4. セル範囲を参照するErrorBarを作成 の続き

err_bar = ErrorBar(errValType='custom', plus=num_data_source, minus=num_data_source)

# 4-2. 誤差範囲のスタイルを調整
from openpyxl.drawing.line import LineProperties
from openpyxl.drawing.colors import SchemeColor

# ShapePropertiesを設定
sp = err_bar.spPr or openpyxl.drawing.shapes.ShapeProperties()
# 線のプロパティを設定（赤色、太さ1.25pt）
sp.ln = LineProperties(solidFill=SchemeColor(val="accent1"), w=12700) # wはEMU単位
err_bar.spPr = sp

chart.errBars = err_bar

# （...後略...）

spPr.lnにLinePropertiesオブジェクトを設定し、solidFillで色（ここではテーマカラーの赤系）、wで線の太さ（単位はEMU。12700が1ptに相当）を指定しています。これにより、誤差範囲がより強調され、読者の注意を引きやすくなります。

まとめ：openpyxlで誤差範囲をマスターして信頼性の高いグラフを作成しよう

今回は、Pythonのopenpyxlライブラリを使ってExcelグラフに誤差範囲（ErrorBar）を追加する方法を解説しました。

  • 誤差範囲の重要性: 平均値だけでなくデータのばらつきを示すことで、グラフの信頼性が向上する。
  • 固定値の誤差範囲: ErrorBar(errValType='fixedVal', value=...)で簡単に追加できる。
  • 動的な誤差範囲: NumDataSourceを使いセル範囲を参照することで、データ毎に異なる誤差を設定できる。
  • スタイリング: spPrプロパティで線の色や太さをカスタマイズし、視認性を高められる。

誤差範囲は、データが持つストーリーをより深く、そして誠実に伝えるための強力なツールです。ぜひこの機能を活用して、あなたのデータ分析やレポート作成の説得力をさらに一段階高めてみてください。

コメント

タイトルとURLをコピーしました