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

Тип кортежа со именами, возвращаемый функцией 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

Тип кортежа со именами, возвращаемый функцией 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]

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

Параметры:

symbolstr

Один символ (Юникод), команда 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').