使用 XeLaTeX/LuaLaTeX 通过 pgf 后端进行文本渲染

使用 pgf 后端，Matplotlib 可以将图形导出为 pgf 绘图命令，这些命令可以使用 pdflatex、xelatex 或 lualatex 进行处理。XeLaTeX 和 LuaLaTeX 具有完整的 Unicode 支持，并且可以使用操作系统中安装的任何字体，从而利用 OpenType、AAT 和 Graphite 的高级排版功能。由 plt.savefig('figure.pgf') 创建的 Pgf 图片可以作为原始命令嵌入到 LaTeX 文档中。通过切换后端，图形也可以直接编译并保存为 PDF 文件，使用 plt.savefig('figure.pdf')。

matplotlib.use('pgf')

或者通过明确请求使用 pgf 后端

plt.savefig('figure.pdf', backend='pgf')

或者通过注册它来处理 PDF 输出

from matplotlib.backends.backend_pgf import FigureCanvasPgf
matplotlib.backend_bases.register_backend('pdf', FigureCanvasPgf)

最后一种方法允许您继续使用常规的交互式后端，并从图形用户界面保存由 xelatex、lualatex 或 pdflatex 编译的 PDF 文件。请注意，在这种情况下，交互式显示仍将使用标准的交互式后端（例如 QtAgg），并且特别会使用 latex 来编译相关的文本片段。

Matplotlib 的 pgf 支持需要最新版本的 LaTeX 安装，其中包含 TikZ/PGF 软件包（例如 TeXLive），最好安装 XeLaTeX 或 LuaLaTeX。如果您的系统上存在 pdftocairo 或 ghostscript，图形也可以选择性地保存为 PNG 图像。所有应用程序的可执行文件都必须位于您的 PATH 中。

控制 pgf 后端行为的 rcParams

参数	文档
pgf.preamble	要包含在 LaTeX 导言区中的行
pgf.rcfonts	使用 fontspec 包从 rc 参数设置字体
pgf.texsystem	可以是 "xelatex"（默认）、"lualatex" 或 "pdflatex"

注意

TeX 定义了一组特殊字符，例如

# $ % & ~ _ ^ \ { }

通常，这些字符必须正确转义。为方便起见，一些字符（_、^、%）在数学环境之外会自动转义。其他字符不会转义，因为它们在实际的 TeX 表达式中通常需要。但是，可以通过自定义导言区配置 TeX 将它们视为“普通”字符（TeX 中称为“catcode 12”），例如

plt.rcParams["pgf.preamble"] = (
    r"\AtBeginDocument{\catcode`\&=12\catcode`\#=12}")

多页 PDF 文件

pgf 后端还支持使用 PdfPages 的多页 PDF 文件

from matplotlib.backends.backend_pgf import PdfPages
import matplotlib.pyplot as plt

with PdfPages('multipage.pdf', metadata={'author': 'Me'}) as pdf:

    fig1, ax1 = plt.subplots()
    ax1.plot([1, 5, 3])
    pdf.savefig(fig1)

    fig2, ax2 = plt.subplots()
    ax2.plot([1, 5, 3])
    pdf.savefig(fig2)

字体规范

用于获取文本元素大小或将图形编译为 PDF 时使用的字体通常在 rcParams 中定义。您也可以通过清除 rcParams["font.serif"]（默认值：['DejaVu Serif', 'Bitstream Vera Serif', 'Computer Modern Roman', 'New Century Schoolbook', 'Century Schoolbook L', 'Utopia', 'ITC Bookman', 'Bookman', 'Nimbus Roman No9 L', 'Times New Roman', 'Times', 'Palatino', 'Charter', 'serif']）、rcParams["font.sans-serif"]（默认值：['DejaVu Sans', 'Bitstream Vera Sans', 'Computer Modern Sans Serif', 'Lucida Grande', 'Verdana', 'Geneva', 'Lucid', 'Arial', 'Helvetica', 'Avant Garde', 'sans-serif']）或 rcParams["font.monospace"]（默认值：['DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Computer Modern Typewriter', 'Andale Mono', 'Nimbus Mono L', 'Courier New', 'Courier', 'Fixed', 'Terminal', 'monospace']）的列表来使用 LaTeX 默认的 Computer Modern 字体。请注意，这些字体的字形覆盖范围非常有限。如果您想保留 Computer Modern 字体外观但需要扩展的 Unicode 支持，请考虑安装 Computer Modern Unicode 字体，例如 CMU Serif、CMU Sans Serif 等。

保存为 .pgf 文件时，Matplotlib 用于图形布局的字体配置会包含在文本文件头部。

import matplotlib.pyplot as plt

plt.rcParams.update({
    "font.family": "serif",
    # Use LaTeX default serif font.
    "font.serif": [],
    # Use specific cursive fonts.
    "font.cursive": ["Comic Neue", "Comic Sans MS"],
})

fig, ax = plt.subplots(figsize=(4.5, 2.5))

ax.plot(range(5))

ax.text(0.5, 3., "serif")
ax.text(0.5, 2., "monospace", family="monospace")
ax.text(2.5, 2., "sans-serif", family="DejaVu Sans")  # Use specific sans font.
ax.text(2.5, 1., "comic", family="cursive")
ax.set_xlabel("µ is not $\\mu$")

自定义导言区

通过在导言区添加您自己的命令，可以实现完全自定义。例如，如果您想使用 unicode-math 配置数学字体，或者加载额外的软件包，请使用 rcParams["pgf.preamble"]（默认值：''）。此外，如果您想自己进行字体配置，而不是使用 rc 参数中指定的字体，请确保禁用 rcParams["pgf.rcfonts"]（默认值：True）。

import matplotlib as mpl

mpl.use("pgf")
import matplotlib.pyplot as plt

plt.rcParams.update({
    "font.family": "serif",  # use serif/main font for text elements
    "text.usetex": True,     # use inline math for ticks
    "pgf.rcfonts": False,    # don't setup fonts from rc parameters
    "pgf.preamble": "\n".join([
         r"\usepackage{url}",            # load additional packages
         r"\usepackage{unicode-math}",   # unicode math setup
         r"\setmainfont{DejaVu Serif}",  # serif font via preamble
    ])
})

fig, ax = plt.subplots(figsize=(4.5, 2.5))

ax.plot(range(5))

ax.set_xlabel("unicode text: я, ψ, €, ü")
ax.set_ylabel(r"\url{https://matplotlib.org.cn}")
ax.legend(["unicode math: $λ=∑_i^∞ μ_i^2$"])

选择 TeX 系统

Matplotlib 使用的 TeX 系统由 rcParams["pgf.texsystem"]（默认值：'xelatex'）选择。可能的值包括 'xelatex'（默认）、'lualatex' 和 'pdflatex'。请注意，当选择 pdflatex 时，字体和 Unicode 处理必须在导言区进行配置。

import matplotlib.pyplot as plt

plt.rcParams.update({
    "pgf.texsystem": "pdflatex",
    "pgf.preamble": "\n".join([
         r"\usepackage[utf8x]{inputenc}",
         r"\usepackage[T1]{fontenc}",
         r"\usepackage{cmbright}",
    ]),
})

fig, ax = plt.subplots(figsize=(4.5, 2.5))

ax.plot(range(5))

ax.text(0.5, 3., "serif", family="serif")
ax.text(0.5, 2., "monospace", family="monospace")
ax.text(2.5, 2., "sans-serif", family="sans-serif")
ax.set_xlabel(r"µ is not $\mu$")

故障排除

• 在 Windows 上，可能需要修改 PATH 环境变量，以包含 latex、dvipng 和 ghostscript 可执行文件所在的目录。详情请参阅环境变量和在 Windows 中设置环境变量。

• 有时，保存为 PNG 图像的图形中字体渲染效果非常差。这发生在 pdftocairo 工具不可用，并且使用 ghostscript 进行 PDF 到 PNG 转换时。

• 请确保您尝试的操作在 LaTeX 文档中是可行的，您的 LaTeX 语法是有效的，并且在必要时使用了原始字符串以避免意外的转义序列。

• rcParams["pgf.preamble"]（默认值：''）提供了很大的灵活性，同时也可能导致许多问题。遇到问题时，请尝试最小化或禁用自定义导言区。

• 配置 unicode-math 环境可能有些棘手。例如，TeXLive 发行版提供了一组数学字体，这些字体通常不会在系统范围内安装。XeLaTeX 与 LuaLaTeX 不同，无法按名称找到这些字体，这就是为什么您可能需要指定 \setmathfont{xits-math.otf} 而不是 \setmathfont{XITS Math}，或者另外使这些字体对您的操作系统可用。有关更多详细信息，请参阅此 tex.stackexchange.com 问题。

• 如果 Matplotlib 使用的字体配置与您 LaTeX 文档中的字体设置不同，则导入图形中文本元素的对齐可能会出现偏差。如果您不确定 Matplotlib 用于布局的字体，请检查您的 .pgf 文件的头部。

• 如果图中包含大量对象，矢量图像以及因此生成的 .pgf 文件可能会变得臃肿。这在图像处理或非常大的散点图中可能会出现。在极端情况下，这可能导致 TeX 内存不足：“TeX capacity exceeded, sorry”。您可以配置 latex 以增加可用于生成 .pdf 图像的内存量，如 tex.stackexchange.com 上所讨论。另一种方法是使用 rasterized=True 关键字或 .set_rasterized(True) 来“栅格化”图中导致问题的部分，如此示例所示。

• 各种数学字体只有在加载了相应的字体包后才能编译和渲染。具体来说，当对希腊字母使用 \mathbf{} 时，默认的 computer modern 字体可能不包含它们，在这种情况下，字母将不会被渲染。在这种情况下，应加载 lmodern 包。

• 如果您仍需要帮助，请参阅获取帮助