K_DM Book
用語集
対象者 標準
対象者別の入口 →

対象者の設定はこのブラウザの中にだけ保存されます。

言語 JA

matplotlib の凡例テクニック

入門

06.8.2

matplotlib の凡例テクニック

最終更新 2024-06-01 読了時間 7 分
まとめ
matplotlib の凡例は ax.legend() を呼ぶだけでも出ますが、既定の loc="best" は 4 系列以上の線が重なるとデータの上に居座ります。このページでは loc と bbox_to_anchor の 2 つの引数で凡例を図の上・下・外へ逃がし、ncol で列数を増やして横幅に収める方法を、sin / cos / sin+cos / sin-cos の 4 系列で確かめます。さらに ax.plot() の戻り値(Line2D)を手で並べ替えて凡例に出す線を絞る方法、fig.legend() で 2 枚のサブプロットに 1 つの凡例を共有させる方法、legend.get_frame() で背景の透明度と枠線を整える方法を扱います。読み終えると、「凡例がデータを隠す」「項目が多くて読めない」という 2 つの悩みを、引数 2〜3 個の変更で解決できるようになります。

直感 #

凡例は図の「地図の記号表」です。線が 4 本あれば読者は 4 回、線の色と凡例を見比べるので、凡例がデータの上にかぶっていたり、図から遠く離れていたりすると、そのたびに視線が迷います。決め手は loc と bbox_to_anchor の 2 つです。loc は「凡例ボックスのどの角を基準にするか」を選び、bbox_to_anchor は「その角を Axes 座標のどこに置くか」を指定します。Axes 座標は左下が (0, 0)、右上が (1, 1) なので、y に 1.18 を渡せば図の上の余白、-0.22 を渡せば図の下の余白に凡例が移ります。以下の 7 つの例はすべてこの 2 つの引数を軸にしていて、最後に plt.tight_layout() で余白を詰め直す点も共通です。


サンプルデータ #

7 つの例で共通に使う 4 本の波を用意します。x は 0 から \(2\pi\) までの 200 点、series は系列名をキー、y 値を値にした辞書で、for label, y in series.items() と回すだけで 4 本を同じ書き方で描けます。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
import numpy as np
import matplotlib.pyplot as plt

x = np.linspace(0, 2*np.pi, 200)
series = {
    "sin": np.sin(x),
    "cos": np.cos(x),
    "sin+cos": np.sin(x) + np.cos(x),
    "sin-cos": np.sin(x) - np.cos(x),
}

1. 位置を自由に調整 (loc + bbox_to_anchor) #

最初の例では、凡例を図の上の余白に 2 列で置きます。loc="upper center" で凡例ボックスの「上辺の中央」を基準点にし、bbox_to_anchor=(0.5, 1.18) でその基準点を Axes の横中央・上端から 18% 上に固定します。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
fig, ax = plt.subplots(figsize=(8, 4))
for label, y in series.items():
    ax.plot(x, y, label=label)

ax.legend(
    loc="upper center",
    bbox_to_anchor=(0.5, 1.18),
    ncol=2,
    frameon=False,
)
ax.set_title("凡例を図の外に配置")
plt.tight_layout()
plt.show()

図の上に 2 行 2 列の凡例が並び、4 本の線はどこも隠れません。ただし出力図では凡例の 2 行目が set_title の文字に重なっています。タイトルを残すなら y を 1.18 から 1.28 程度に上げるか、ncol=4 で 1 行に畳んで凡例の高さを半分にします。

凡例を図の外に配置


2. 表示対象と順番を制御 #

4 本描いたうち 3 本だけを、描いた順とは別の順番で、日本語の名前に差し替えて凡例に出します。鍵になるのは ax.plot() の戻り値(Line2D のリスト)を handle_map に取っておき、ax.legend(handles, labels) に自分で並べた順で渡すことです。"sin-cos" は凡例から外します。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
fig, ax = plt.subplots(figsize=(8, 4))
handle_map = {}
for label, y in series.items():
    handle_map[label] = ax.plot(x, y, label=label)[0]

order = ["sin+cos", "sin", "cos"]
handles = [handle_map[k] for k in order]
labels = ["合成波", "サイン", "コサイン"]

ax.legend(handles, labels, title="注目シリーズ", loc="lower right")
ax.set_title("凡例に出す線を絞り込む")
plt.tight_layout()
plt.show()

図には 4 本の線が描かれていますが、凡例は「注目シリーズ」の見出しの下に 3 項目だけです。日本語ラベルは label= で付けた英語名と無関係に差し替えられているので、分析時の変数名と発表資料の表記を分けたいときにもこの書き方が使えます。

表示対象と順序をカスタマイズ


3. 背景・枠線を整える #

今度は凡例を Axes の内側(loc="upper left")に置き、線と重なっても読めるように白背景と #cbd5e1 の薄い枠線を付けます。ax.legend() の戻り値 legend から get_frame() で枠(FancyBboxPatch)を取り出し、透明度 0.9 と線幅 0.8 を後から設定するのがポイントです。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
fig, ax = plt.subplots(figsize=(8, 4))
for label, y in series.items():
    ax.plot(x, y, linewidth=2, label=label)

legend = ax.legend(
    loc="upper left",
    bbox_to_anchor=(0.02, 0.98),
    frameon=True,
    facecolor="white",
    edgecolor="#cbd5e1",
)
legend.get_frame().set_alpha(0.9)
legend.get_frame().set_linewidth(0.8)

ax.set_title("凡例に背景と枠線を付与")
ax.grid(alpha=.3)
plt.tight_layout()
plt.show()

左上の凡例は白地に薄いグレーの枠で、下を通る sin+cos の線が 1 割だけ透けて見えます。グリッドや線が多い図では、frameon=False で枠を消すより、こうして白背景を少し透かす方が凡例と図の両方を読めます。

背景と枠線を調整


4. サブプロット共通の凡例 (fig.legend) #

2 枚のサブプロットに同じ 4 系列を描くとき、各 Axes に ax.legend() を付けると同じ凡例が 2 回出ます。代わりに Figure 側の fig.legend() を 1 回呼び、Figure 座標で上中央に 4 列の共通凡例を置きます。ax.legend() は一度も呼びません。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
fig, axes = plt.subplots(1, 2, figsize=(10, 4), sharey=True)

for ax, factor in zip(axes, [1.0, 0.5]):
    for label, y in series.items():
        ax.plot(x, factor * y, label=label)
    ax.set_title(f"factor={factor}")

fig.legend(
    loc="upper center",
    bbox_to_anchor=(0.5, 1.04),
    ncol=4,
    title="共通凡例",
)
fig.tight_layout()
plt.show()

左右 2 枚のサブプロットの上に「共通凡例」が 1 行 4 列で載り、各サブプロットの中には凡例がありません。凡例の箱が factor=1.0 のタイトルに重なっているのは fig.tight_layout() が fig.legend を見ないためで、タイトルを読ませたいときは上の注釈のように描画領域を下げます。同じ系列を条件別に並べて比べるダッシュボード風の図では、凡例を 1 つにすると読者が線の色を覚える回数が 1 回で済みます。

サブプロット共通の凡例


5. 凡例内の線幅・マーカーを強調 #

本体の線は 1.5 pt のまま、凡例の線見本だけ 3 pt に太くしたい、という場面があります。legend.legend_handles(古い版では legendHandles)から凡例側の Line2D を取り出し、set_linewidth(3.0) と set_markersize(8) を凡例だけに適用します。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
fig, ax = plt.subplots(figsize=(8, 4))
for label, y in series.items():
    ax.plot(x, y, marker="o", markersize=4, label=label)

legend = ax.legend(
    loc="upper left",
    bbox_to_anchor=(0.02, 1.02),
)

handles = getattr(legend, "legendHandles", legend.legend_handles)
for handle in handles:
    handle.set_linewidth(3.0)
    handle.set_markersize(8)

ax.set_title("凡例中の線とマーカーを強調")
plt.tight_layout()
plt.show()

図の中の線は細い丸マーカー付きのまま、凡例の線見本だけが太い線と大きな丸で表示されます。本体の線を太くすると sin と cos の交点付近が塗りつぶされてしまうので、凡例側だけを強調するのがプレゼン向きの選び方です。

凡例中の線とマーカーを強調


6. 凡例を二段組で図の下に配置 #

x 軸ラベルの下に凡例を 2 列で置く例です。bbox_to_anchor の y を -0.22 と負にすると凡例が Axes の下に出ます。系列ごとに 0.2 ずつオフセットを足して線をずらし、label にそのオフセット量を f 文字列で埋め込んでいます。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
fig, ax = plt.subplots(figsize=(8, 4))
for idx, (label, y) in enumerate(series.items(), start=1):
    ax.plot(x, y + idx * 0.2, label=f"{label} + {idx*0.2:.1f}")

ax.legend(
    loc="upper center",
    bbox_to_anchor=(0.5, -0.22),
    ncol=2,
    title="各系列とオフセット",
    frameon=False,
)
ax.margins(x=0.02, y=0.1)
ax.set_title("凡例を図の下に 2 列で配置")
plt.tight_layout()
plt.show()

図の下、x 軸ラベルのさらに下に「各系列とオフセット」の見出し付きで 2 行 2 列の凡例が並びます。横長の図で上にタイトルがあるときは、凡例を下に送ると上下のバランスが取れます。

図の下に 2 列凡例


7. 面グラフや基準線の凡例 #

凡例に載せられるのは Line2D だけではありません。fill_between で塗った面と、axhline で引いた基準線にも label を付けると、凡例には色付きの四角と破線の見本がそれぞれ入ります。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
fig, ax = plt.subplots(figsize=(8, 4))
ax.fill_between(x, np.sin(x), color="#3b82f6", alpha=0.35, label="元データ範囲")
ax.fill_between(x, np.sin(x), np.sin(x) + 0.3, color="#10b981", alpha=0.45, label="上振れ幅")
ax.axhline(0, color="#475569", linestyle="--", linewidth=1.2, label="基準線")

ax.legend(
    loc="upper right",
    bbox_to_anchor=(1.02, 1.0),
    borderpad=0.8,
)
ax.set_ylim(-1.5, 1.8)
ax.set_title("fill_between + 基準線の凡例")
plt.tight_layout()
plt.show()

凡例には青と緑の半透明の四角、そしてグレーの破線の 3 項目が並びます。塗りの alpha が凡例の四角にもそのまま反映されるので、本体で薄くしすぎると凡例の色見本もほとんど白に見える点には注意が必要です。

面グラフと基準線の凡例

使いどころと落とし穴 #

使いどころは 3 つです。凡例の調整が効くのは、4 系列以上の線が交差する図、2 枚以上のサブプロットで同じ系列を比べる図、fill_between の面と基準線が混ざる図です。逆に 1 系列だけの図に凡例を付けると、タイトルと同じ情報を 2 回書くことになるので、ax.set_title() か線の端に ax.text() でラベルを直接書く方が読みやすくなります。系列が 2〜3 本でも、線の右端に ax.annotate() で名前を書く「直接ラベル」なら読者の視線が凡例と線を往復しません。

いちばん多い失敗は、既定の loc="best" に任せたままデータの上に凡例が乗ることです。loc="best" は線と重ならない位置を探しますが、今回の 4 系列のように図の全域に線があると、どこに置いても重なります。そのときは例 1 のように bbox_to_anchor の y を 1.1 以上にして図の外へ出すか、例 3 のように半透明の白背景を付けます。もう一つの失敗は、10 項目を超える凡例をそのまま出すことです。10 色の区別は色覚に関係なく難しいので、例 2 の handles の絞り込みで注目系列だけを凡例に出すか、系列を 3〜4 のグループに束ねて ncol で折り返します。

まとめ #

matplotlib の凡例は loc で凡例ボックス側の基準点を、bbox_to_anchor でその基準点を置く Axes 座標を決める、という 2 段構えで位置が決まります。y に 1.18 なら図の上、-0.22 なら図の下です。fig.legend() なら Figure 座標で複数サブプロットの上中央に 1 つだけ置けます。ax.plot() の戻り値 Line2D を handles として自分で並べ替えれば表示する系列と順番と文字列を分離でき、legend.get_frame() と legend.legend_handles を使えば凡例の見た目だけを本体と独立に調整できます。どの例も最後に plt.tight_layout() を呼ぶのは、外に出した凡例の分だけ余白を確保しないと保存画像で凡例が切れるためです。