matplotlib.mathtext

Модуль для синтаксического анализа подмножества TeX-математического синтаксиса и его отображения в бэкенде Matplotlib.

Для ознакомления с руководством по его использованию, см. Написание математических выражений. Данный документ в основном посвящен деталям реализации.

В модуле используется pyparsing для синтаксического анализа TeX-выражения.

Поддерживаются шрифты Computer Modern из дистрибутива Bakoma TeX и шрифты STIX. Существует экспериментальная поддержка использования произвольных шрифтов, но результаты могут варьироваться без надлежащей настройки и метрик для этих шрифтов.

classmatplotlib.mathtext.MathTextParser(output)[source]

Базовый класс: object

Создает MathTextParser для заданного бэкенда output.

Параметры:

output{"path", "agg"}

Определяет, возвращать VectorParse ("path") или RasterParse ("agg", или его синоним "macosx").

parse(s, dpi=72, prop=None, *, antialiased=None)[source]

Анализирует заданное математическое выражение s при заданном dpi. Если указан prop, это объект FontProperties, определяющий "стандартный" шрифт для использования в математическом выражении, используемый для всего не-математического текста.

Результаты кешируются, поэтому многократные вызовы parse с одинаковым выражением должны быть быстрыми.

В зависимости от типа output, это возвращает либо VectorParse, либо RasterParse.

classmatplotlib.mathtext.RasterParse(ox, oy, width, height, depth, image)[source]

Базовый класс: NamedTuple

Тип namedtuple, возвращаемый MathTextParser("agg").parse(...).

Атрибуты:

ox, oyfloat

Офсеты всегда равны нулю.

width, height, depthfloat

Глобальные метрики.

imageFT2Image

Растровое изображение.

Создаёт новый экземпляр RasterParse(ox, oy, width, height, depth, image)

depth

Псевдоним для поля номер 4

height

Псевдоним для поля номер 3

image

Псевдоним для поля номер 5

ox

Псевдоним для поля номер 0

oy

Псевдоним для поля номер 1

width

Псевдоним для поля номер 2

classmatplotlib.mathtext.VectorParse(width, height, depth, glyphs, rects)[source]

Базовый класс: NamedTuple

Тип namedtuple, возвращаемый MathTextParser("path").parse(...).

Атрибуты:

width, height, depthfloat

Глобальные метрики.

glyphslist

Глифы, включая их позиции.

rectlist

Список прямоугольников.

Создаёт новый экземпляр VectorParse(width, height, depth, glyphs, rects)

depth

Псевдоним для поля номер 2

glyphs

Псевдоним для поля номер 3

height

Псевдоним для поля номер 1

rects

Псевдоним для поля номер 4

width

Псевдоним для поля номер 0

matplotlib.mathtext.get_unicode_index(symbol)[source]

Возвращает целочисленный индекс (из таблицы Unicode) символа symbol.

Параметры:

symbolstr

Один символ (Unicode), команда TeX (например, r'pi') или имя символа Type1 (например, 'phi').

matplotlib.mathtext.math_to_image(s, filename_or_obj, prop=None, dpi=None, format=None, *, color=None)[source]

Отображает математическое выражение в ограниченной области и сохраняет результат в виде изображения.

Параметры:

sstr

Математическое выражение. Математическая часть должна быть заключена в знаки доллара.

filename_or_objstr или объект-путь или объект файла

Куда записать данные изображения.

propFontProperties, необязательно

Размер и стиль текста.

dpifloat, необязательно

DPI выходного изображения. Если не задано, DPI определяется как для Figure.savefig.

formatstr, необязательно

Формат выходного файла, например, 'svg', 'pdf', 'ps' или 'png'. Если не задано, формат определяется как для Figure.savefig.

colorstr, необязательно

Цвет переднего плана, по умолчанию rcParams["text.color"] (по умолчанию: 'black').