Latex 文本渲染

在matplotlib中使用 Latex 渲染文本。

Matplotlib可以选择使用LaTex来管理所有文本布局。此选项可用于以下后端：

自动增益控制
PS
PDF

Latex 选项通过设置激活 text.usetex : True 在RC设置中。Matplotlib的 Latex 支持下的文本处理速度比Matplotlib的超能力慢。 mathtext 但更灵活，因为可以使用不同的 Latex 包（字体包、数学包等）。结果可能是惊人的，尤其是当您注意使用与主文档中相同的字体时。

Matplotlib的 Latex 支架需要工作 LaTeX 安装， dvipng （可能包括在 Latex 装置中），以及 Ghostscript （需要gpl ghostscript 9.0或更高版本）。这些外部依赖项的可执行文件必须全部位于 PATH .

有几个选项需要提及，可以使用 rc settings . 以下是matplotlibrc文件的示例：

font.family        : serif
font.serif         : Times, Palatino, New Century Schoolbook, Bookman, Computer Modern Roman
font.sans-serif    : Helvetica, Avant Garde, Computer Modern Sans serif
font.cursive       : Zapf Chancery
font.monospace     : Courier, Computer Modern Typewriter

text.usetex        : true

每个族中的第一个有效字体是将要加载的字体。如果未指定字体，则默认使用计算机现代字体。所有其他字体都是Adobe字体。时代和帕拉蒂诺各自都有自己的数学字体，而其他的Adobe serif字体则利用计算机的现代数学字体。见 PSNFSS 有关详细信息的文档。

要使用 Latex 并选择Helvetica作为默认字体，而不编辑matplotlibrc，请使用：

from matplotlib import rc
rc('font',**{'family':'sans-serif','sans-serif':['Helvetica']})
## for Palatino and other serif fonts use:
#rc('font',**{'family':'serif','serif':['Palatino']})
rc('text', usetex=True)

下面是标准示例， tex_demo.py ：

特克斯演示

注意显示数学模式 ($$ e=mc^2 $$ ）不支持，但添加命令 \displaystyle ，如 tex_demo.py 将产生相同的结果。

注解

某些字符需要用tex进行特殊转义，例如：

# $ % & ~ _ ^ \ { } \( \) \[ \]

因此，根据rcparam，这些字符的行为会有所不同 text.usetex 旗帜。

带Unicode的UseTex¶

也可以将Unicode字符串与LaTex文本管理器一起使用，下面是一个示例 tex_demo.py . 轴标签包括Unicode文本：

Tex Unicode演示

PostScript选项¶

为了生成可嵌入到新的LaTex文档中的封装PostScript文件，Matplotlib的默认行为是提取输出，这会删除LaTex使用的某些PostScript运算符，这些运算符在EPS文件中是非法的。这一步会产生一些用户可能无法接受的结果，因为文本被粗栅格化并转换为位图，而位图不像标准PostScript那样可伸缩，并且文本不可搜索。一个解决方法是 ps.distiller.res 在RC设置中设置为更高的值（可能为6000），这将生成更大的文件，但可能看起来更好并具有合理的缩放比例。更好的解决方案，这需要 Poppler 或 Xpdf, 可以通过更改 ps.usedistiller RC设置 xpdf . 这种替代方法生成PostScript而不栅格化文本，因此可以适当缩放，可以在Adobe Illustrator中编辑，并在PDF文档中搜索文本。

可能的宿醉¶

在Windows上 PATH 可能需要修改环境变量，以包括包含LaTex、Dvipng和Ghostscript可执行文件的目录。见环境变量和在Windows中设置环境变量有关详细信息。
使用Miktex和电脑现代字体，如果你感到奇怪 * agg和png结果，转到miktex/options并更新格式文件
在Ubuntu和Gentoo上，Base-TexLive安装不附带1cm型软件包。您可能需要安装一些额外的软件包，以获得与其他 Latex 分发捆绑在一起的所有商品。
已经取得了一些进展，因此matplotlib直接将dvi文件用于文本布局。这使得LaTex可以用于PDF和SVG后端的文本布局，以及 * AGG和PS后端。将来， Latex 安装可能是唯一的外部依赖。

故障排除¶

尝试删除您的 .matplotlib/tex.cache 目录。如果你不知道在哪能找到 .matplotlib 见 matplotlib 配置和缓存目录位置 .
确保LaTex、Dvipng和Ghostscript都在工作，并且 PATH .
确保您正在尝试的操作在LaTex文档中是可能的，确保您的LaTex语法有效，并且在必要时使用原始字符串以避免意外的转义序列。
邮件列表中报告的大多数问题已通过升级清除 Ghostscript. 如果可能，请在向列表报告问题之前尝试升级到最新版本。
这个 text.latex.preamble 未正式支持RC设置。这个选项提供了许多灵活性，以及许多导致问题的方法。在向邮件列表报告问题之前，请禁用此选项。
如果您仍需要帮助，请参阅得到帮助

Download Python source code: usetex.py

Download Jupyter notebook: usetex.ipynb

Navigation

目录

Related Topics