HOWTO · Matplotlib

Python Matplotlib でギリシャ文字を表示する

このチュートリアルでは、Python で matplotlib を使用してギリシャ文字を表示する方法について説明します。

このページの内容

Matplotlib のタイトル、軸ラベル、注釈にギリシャ文字を入れるには、r"$\alpha$" のような Mathtext を使う方法、Python の chr() で Unicode コードポイントから文字を作る方法、Unicode 文字を文字列に直接入力する方法があります。数式を含むラベルには Mathtext が手軽で、通常のテキストには Unicode の直接入力が便利です。ラベルをパスとして扱いたい場合は TextPath が使えます。(matplotlib)

Mathtext で Matplotlib にギリシャ文字を表示する

Matplotlib に組み込まれた Mathtext パーサーは、外部 LaTeX レンダリングを有効にしなくても、よく使われる多くの数式表現を解釈できます。数式表現をドル記号で囲み、バックスラッシュがそのままパーサーに渡るよう Python の raw 文字列を使います。ギリシャ文字の名前の前にバックスラッシュを付けると、たとえば r"$\alpha$" は α として描画されます。同じ書き方をタイトル、軸ラベル、注釈に使えます。

次の完全な例では、グラフのタイトルに2つの記号を入れ、両方の軸にラベルを付けます。

import matplotlib.pyplot as plt

fig, ax = plt.subplots()
ax.plot([0, 1, 2], [0, 1, 4])
ax.set_title(r"$\alpha$ and $\beta$")
ax.set_xlabel(r"$\mu$")
ax.set_ylabel(r"$\sigma$")
plt.show()

数式表現を同じ文字列に含めれば、Mathtext と前後の単語を組み合わせられます。たとえば r"Mean $\mu$ and spread $\sigma$" のように書けます。各数式表現は、それぞれ一組のドル記号で囲んでください。ドル記号そのものを表示する方法や、より高度な表記については、Matplotlib の Mathtext 構文を参照してください。ここで示した例に text.usetex=True は不要です。

Python の chr() で Unicode コードポイントを文字に変換する

Python の chr() は整数の Unicode コードポイントを受け取り、対応する文字を返します。たとえば chr(945) は α です。945 から 969 までの値は、小文字のギリシャ文字に対応するコードポイントを含み、末尾のシグマ(ς)も含まれます。chr() はアルファベットに限らず、Unicode のコードポイント全般に使えます。データや数値設定から記号を決める場合に便利です。

import matplotlib.pyplot as plt

alpha = chr(945)
beta = chr(946)
fig, ax = plt.subplots()
ax.plot([0, 1, 2], [0, 1, 4])
ax.set_title(f"{alpha} and {beta}")
ax.set_xlabel(alpha)
plt.show()

返された文字は、ほかの Python 文字列と同じように通常のテキストや別の文字列と組み合わせられます。chr() が変換するのはコードポイントから文字への方向であり、文字を整数に変換するものではありません。ここに挙げた例以外の記号が必要な場合は、Unicode 文字表でコードポイントを確認してください。

Matplotlib で Unicode 文字を直接使う

短いラベルなら、ギリシャ文字を Python 3 の文字列に直接入力できます。ソースコード上で意図したテキストを読み取りやすくできる方法です。ただし、選択中の Matplotlib フォントにそのグリフが含まれている必要があります。文字が四角で表示されたり欠けたりする場合は、その文字に対応したフォントを選んでください。

import matplotlib.pyplot as plt

fig, ax = plt.subplots()
ax.plot([0, 1, 2], [0, 1, 4])
ax.set_title("α and β")
ax.set_xlabel("μ")
ax.set_ylabel("σ")
plt.show()

the __future__ module から unicode_literals をインポートする Python 2 の方法は、過去の互換性に関する情報です。現在の Python コードでは、上に示した通常の Python 3 の文字列の使い方を選んでください。

TextPath でパスベースのテキストラベルを作成する

TextPath はテキストを Matplotlib のパスに変換します。作成したパスはパッチとして追加し、スタイルを設定できます。これは、パスを使った独自のラベルや図形を作るための発展的な方法です。通常のグラフタイトルや軸ラベルには、前述の方法のほうが簡単です。ほかのテキストと同様、グリフの見た目は利用可能なフォントに左右されます。

次の例では、α-beta のパスを作成して Axes に追加し、パスが収まるように表示範囲を調整します。

この保持された例で表示されるラベルは、英語のままです。

import matplotlib.pyplot as plt
from matplotlib.patches import PathPatch
from matplotlib.textpath import TextPath

text_path = TextPath((0, 0), "α-beta", size=24)
patch = PathPatch(text_path, facecolor="royalblue", edgecolor="none")
fig, ax = plt.subplots()
ax.add_patch(patch)
ax.autoscale_view()
ax.set_aspect("equal")
ax.set_axis_off()
plt.show()

TextPath の座標はラベルの形状と開始位置を定義します。PathPatch で塗りつぶしのスタイルを指定し、autoscale_view() で追加したパッチを含むように表示中の Axes の範囲を調整します。通常のタイトル、ラベル、注釈には Mathtext または Unicode を使うと、Matplotlib がテキストの配置や位置合わせを処理します。