HOWTO · Matplotlib
Python エラーバー
Python で Matplotlib の errorbar()関数を使用して、エラーバー付きのデータをプロットできます。
このページの内容
Matplotlibのerrorbar()を使うと、yerrで縦方向、xerrで横方向、または両方の不確かさを付けて測定値をプロットできます。以下の例では固定値を使い、それぞれの引数がプロットをどう変えるかを確認できるようにしています。
Pythonでエラーバーを描画する
エラーバーは、プロットした測定値の周りにある不確かさの大きさを示します。たとえば、許容差が記された抵抗器には、確実にその値だと言える単一の値ではなく、取り得る値の範囲があります。グラフ上のエラーバーはデータ点の周りにその範囲を示しますが、測定値そのものを変えるものではありません。
次の例を実行します。
import matplotlib.pyplot as plt
x_values = [1, 2, 3, 4]
y_values = [1, 2, 3, 4]
y_error = [0.9, 0.5, 0.75, 0.25]
plt.errorbar(x_values, y_values, yerr=y_error)
plt.show()
この例では、縦方向のエラーバー付きで4点を描画します。yerrには、対応する各y値の縦方向の誤差範囲を指定します。y_errorリストには各点につき1つの値があるため、値の長さはプロットするデータと対応しています。Matplotlibでは、全点に共通するスカラー値や、下側と上側の範囲を指定する2行の配列も使えます。いずれの形式でも、データの形状に合うように指定する必要があります。すべての点で同じ対称な不確かさを使う場合はスカラー値、点ごとに異なる対称な不確かさを使う場合はシーケンス、非対称な不確かさには下側と上側を別々に指定します。このプロットで使っているのは固定リストであり、ランダムに生成した測定値ではありません。
横方向の不確かさも表示するには、xerrの値を渡します。次の例では同じ4つの固定点を使い、各点に0.5の横方向の範囲を指定しています。その結果、x軸方向のエラーバーは横向きに表示され、yerrによる縦方向のエラーバーも引き続き描画されます。
import matplotlib.pyplot as plt
x_values = [1, 2, 3, 4]
y_values = [1, 2, 3, 4]
y_error = [0.9, 0.5, 0.75, 0.25]
x_error = [0.5, 0.5, 0.5, 0.5]
plt.errorbar(x_values, y_values, yerr=y_error, xerr=x_error, fmt="--ro", ms=10)
plt.show()
fmt="--ro"という短い書式文字列は、破線(--)、赤色(r)、円形マーカー(o)を組み合わせたものです。fmtでデータ線のスタイル、色、マーカーを選べます。より細かく調整する場合は、個別の描画オプションを使います。msはマーカーのサイズを設定します。マーカーの見た目については、mec(別名markeredgecolor)で輪郭の色、mfc(別名markerfacecolor)で塗りつぶしの色、mew(別名markeredgewidth)で輪郭の幅を変更できます。これらのオプションが変えるのはデータマーカーであり、エラーバーではありません。
エラーバーのスタイルには専用の引数があります。ecolorはエラーバーの色を設定し、たとえばecolor="g"なら緑色になります。elinewidthは線の幅を指定します。capsizeは端に付く短い横線(キャップ)の長さ、capthickはその太さを調整します。キャップはエラーバーの端を示すもので、データマーカーではありません。既定の見た目を決めつけず、グラフの尺度や視覚的なバランスに合わせて値を設定してください。
次の例では、同じデータに線とマーカーの書式設定を組み合わせています。
import matplotlib.pyplot as plt
x_values = [1, 2, 3, 4]
y_values = [1, 2, 3, 4]
y_error = [0.9, 0.5, 0.75, 0.25]
x_error = [0.5, 0.5, 0.5, 0.5]
plt.errorbar(
x_values,
y_values,
yerr=y_error,
xerr=x_error,
fmt="--ro",
ms=10,
ecolor="g",
elinewidth=3,
capsize=10,
capthick=3,
)
plt.show()
点が多いグラフでは、すべての点にエラーバーを表示すると読み取りにくくなることがあります。erroreveryを使うと、データ線とマーカーを残したまま、エラーバーを表示するデータ点を選べます。たとえばerrorevery=2では、系列の最初の点から始めて、1つおきにエラーバーを表示します。この引数が変えるのはエラーバーの表示位置であり、元のデータや線ではありません。選択の開始位置をずらす場合は、整数の間隔、または開始位置と間隔の組み合わせを指定できます。
データ線と円形マーカーを残しながら、1つおきの点にエラーバーを表示するには、次の例を実行します。
import matplotlib.pyplot as plt
x_values = [1, 2, 3, 4]
y_values = [1, 2, 3, 4]
y_error = [0.9, 0.5, 0.75, 0.25]
plt.errorbar(x_values, y_values, yerr=y_error, fmt="-o", errorevery=2)
plt.show()
データが示す内容に合わせてオプションを選びます。縦方向の測定値の不確かさにはyerr、横方向にはxerrを使い、両方に不確かさがある場合は両方を指定します。各誤差値を対応する点に合わせ、非対称な不確かさには下側と上側の範囲を別々に指定します。そのうえで、読みやすさに応じてfmt、マーカーのオプション、エラーバーのスタイルを調整します。プロットが見づらくなる場合は、erroreveryで表示するエラーバーの数を減らしながら、プロットした観測値を保てます。