matplotlib.mathtext

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

Руководство по использованию см. в разделе Запись математических выражений. Этот документ посвящён главным образом деталям реализации.

Для разбора выражений TeX в модуле используется pyparsing.

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

classmatplotlib.mathtext.MathTextParser(output)[исходный код]

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

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

Параметры:

output{"path", "agg"}

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

parse(s, dpi=72, prop=None, *, antialiased=None)[исходный код]

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

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

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

classmatplotlib.mathtext.RasterParse(ox, oy, width, height, depth, image)[исходный код]

Базовые классы: 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)[исходный код]

Базовые классы: 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)[исходный код]

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

Параметры:

symbolstr

Один символ 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 or path-like or file-like

Место для записи данных изображения.

propFontProperties, optional

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

dpifloat, optional

Выходное значение dpi. Если не задано, оно определяется так же, как для Figure.savefig.

formatstr, optional

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

colorstr, optional

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