matplotlib.mathtext#

Inheritance diagram of matplotlib.mathtext

一个用于解析 TeX 数学语法子集并将其渲染到 Matplotlib 后端的模块。

有关其用法的教程,请参阅 书写数学表达式。本文档主要关注实现细节。

该模块使用 pyparsing 来解析 TeX 表达式。

支持 Bakoma 分发的 TeX Computer Modern 字体和 STIX 字体。对于使用任意字体的实验性支持,但如果没有对这些字体的适当调整和度量,结果可能会有所不同。

class matplotlib.mathtext.MathTextParser(output)[源代码][源代码]#

基类:object

为给定的后端 output 创建一个 MathTextParser。

参数:
输出{"路径", "聚合"}

是否返回一个 `VectorParse`(“路径”)或一个 `RasterParse`(“agg”,或其同义词“macosx”)。

parse(s, dpi=72, prop=None, *, antialiased=None)[源代码][源代码]#

解析给定的数学表达式 s 在给定的 dpi 下。如果提供了 prop ,它是一个 FontProperties 对象,指定数学表达式中使用的“默认”字体,用于所有非数学文本。

结果会被缓存,因此对 parse 的多次相同表达式调用应该会很快。

根据 输出 类型,这将返回一个 VectorParse 或一个 RasterParse

class matplotlib.mathtext.RasterParse(ox, oy, width, height, depth, image)[源代码]#

基类:NamedTuple

MathTextParser("agg").parse(...) 返回的命名元组类型。

属性:
ox, oy浮动

偏移量始终为零。

宽度, 高度, 深度浮动

全局指标。

图像FT2Image

光栅图像。

创建 RasterParse(ox, oy, width, height, depth, image) 的新实例

depth#

字段编号4的别名

height#

字段编号3的别名

image#

字段编号 5 的别名

ox#

字段编号 0 的别名

oy#

字段编号1的别名

width#

字段编号2的别名

class matplotlib.mathtext.VectorParse(width, height, depth, glyphs, rects)[源代码]#

基类:NamedTuple

MathTextParser("path").parse(...) 返回的命名元组类型。

属性:
宽度, 高度, 深度浮动

全局指标。

字形列表

包括它们位置的字形。

矩形列表

矩形列表。

创建 VectorParse(width, height, depth, glyphs, rects) 的新实例

depth#

字段编号2的别名

glyphs#

字段编号3的别名

height#

字段编号1的别名

rects#

字段编号4的别名

width#

字段编号 0 的别名

matplotlib.mathtext.get_unicode_index(symbol)[源代码]#

返回 symbol 的整数索引(来自 Unicode 表)。

参数:
符号str

一个单一的(Unicode)字符、一个 TeX 命令(例如 r'pi')或一个 Type1 符号名称(例如 'phi')。

matplotlib.mathtext.math_to_image(s, filename_or_obj, prop=None, dpi=None, format=None, *, color=None)[源代码][源代码]#

给定一个数学表达式,将其渲染到一个紧密裁剪的边界框中,并保存为图像文件。

参数:
sstr

一个数学表达式。数学部分必须用美元符号括起来。

filename_or_objstr 或 path-like 或 file-like

图像数据应写入的位置。

prop : FontProperties, 可选FontProperties,可选

文本的大小和样式。

dpi浮点数,可选

输出 dpi。如果未设置,dpi 将根据 Figure.savefig 确定。

格式str, 可选

输出格式,例如 'svg'、'pdf'、'ps' 或 'png'。如果未设置,格式将根据 Figure.savefig 确定。

颜色str, 可选

前景色,默认为 rcParams["text.color"] (default: 'black')。