HOWTO · Matplotlib
在 Python Matplotlib 中显示希腊字母
本教程讨论如何在 Python 中使用 matplotlib 显示希腊字母。
本页内容
要在 Matplotlib 图表标题、坐标轴标签或注释中加入希腊字母,可以使用 Mathtext,例如 r"$\alpha$";也可以用 Python 的 chr() 根据 Unicode 码点生成字符,或直接在字符串中输入 Unicode 字符。数学标签通常用 Mathtext 最简单;普通文本中直接使用 Unicode 很方便;如果标签需要作为路径处理,则可使用 TextPath。(matplotlib)
在 Matplotlib 中使用 Mathtext 显示希腊字母
Matplotlib 内置的 Mathtext 解析器可以识别许多常见数学表达式,无须启用外部 LaTeX 渲染。将表达式放在美元符号之间,并使用 Python 原始字符串,以便反斜杠原样传递给解析器。在希腊字母名称前加反斜杠:r"$\alpha$" 会渲染为 α。同样的语法也适用于标题、坐标轴标签和注释。
下面的完整示例会在图表标题中放置两个符号,并为两个坐标轴添加标签:
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 对应小写希腊字母的码点,其中包括词尾 sigma(ς)。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()
Python 2 中从 __future__ 模块导入 unicode_literals 仅是历史兼容背景。编写当前的 Python 代码时,请使用上面展示的常规 Python 3 字符串写法。
使用 TextPath 创建基于路径的文本标签
TextPath 会将文本转换为 Matplotlib 路径,你可以将其添加为补丁对象并设置样式。这是用于自定义路径标签或形状的进阶选项;普通图表标题和坐标轴标签用前面介绍的方法更简单。和其他文本一样,字形能否正确显示取决于字体是否可用。
下面的示例会为 α-beta 创建路径,将其添加到坐标轴,并让坐标轴范围适应该路径:
这个保留示例中可见的标签仍为英文。
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() 则会调整可见坐标轴范围,使其包含新添加的补丁对象。对于普通标题、标签或注释,优先使用 Mathtext 或 Unicode,让 Matplotlib 负责文本的位置和对齐。