Spec-Zone.ru › Matplotlib 3.3

matplotlib.mathtext

Inheritance diagram of matplotlib.mathtext

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

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

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

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

class matplotlib.mathtext.Accent(c, state, math=True) [исходный код]

Базовый класс: matplotlib.mathtext.Char

Метрики шрифта для акцентов необходимо обрабатывать по-другому, так как они уже правильно смещены от базовой линии в шрифтах TrueType.

grow(self) [исходный код]

Увеличивает размер на один уровень. Нет ограничений на максимальный размер.

render(self, x, y) [исходный код]

Отображает символ на холсте.

shrink(self) [исходный код]

Уменьшает размер на один уровень. После трёх уровней уменьшения, размер больше не будет изменяться.

class matplotlib.mathtext.AutoHeightChar(c, height, depth, state, always=False, factor=None) [исходный код]

Базовые классы: matplotlib.mathtext.Hlist

Символ с высотой и глубиной, максимально приближенными к заданным.

При использовании шрифта с несколькими вариантами высоты некоторых символов (например, шрифтов BaKoMa) будет выбран правильный глиф; в противном случае всегда будет возвращаться масштабированная версия глифа.

class matplotlib.mathtext.AutoWidthChar(c, width, state, always=False, char_class=<class 'matplotlib.mathtext.Char'>) [исходный код]

Базовые классы: matplotlib.mathtext.Hlist

Символ с шириной, максимально приближенной к заданной.

При использовании шрифта с несколькими вариантами ширины некоторых символов (например, шрифтов BaKoMa) будет выбран правильный глиф; в противном случае всегда будет возвращаться масштабированная версия глифа.

class matplotlib.mathtext.BakomaFonts(*args, **kwargs) [исходный код]

Базовые классы: matplotlib.mathtext.TruetypeFonts

Использование шрифтов Bakoma TrueType для рендеринга.

Символы разбросаны по нескольким файлам шрифтов, каждый из которых имеет собственную собственную кодировку 8-бит.

Параметры:
default_font_prop: `~.font_manager.FontProperties`

Стандартный шрифт, не используемый для математических символов, или базовый шрифт для рендеринга символов Юникода (общий).

mathtext_backend: `MathtextBackend` subclass

Подсистема, к которой фактически делегируется рендеринг.

alias = '\\]'
get_sized_alternatives_for_symbol(self, fontname, sym) [исходный код]

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

target = ']'
class matplotlib.mathtext.Box(width, height, depth) [исходный код]

Базовые классы: matplotlib.mathtext.Node

Узел с физическим расположением.

grow(self) [исходный код]

Увеличивает размер на один уровень. Нет ограничений на максимальный размер.

render(self, x1, y1, x2, y2) [исходный код]
shrink(self) [исходный код]

Уменьшает размер на один уровень. Существует только три уровня уменьшения размера, после чего дальнейшее уменьшение невозможно.

class matplotlib.mathtext.Char(c, state, math=True) [исходный код]

Базовые классы: matplotlib.mathtext.Node

Один символ.

В отличие от TeX, информация о шрифте и метрики хранятся с каждым Char, чтобы облегчить поиск метрик шрифта при необходимости. Обратите внимание, что TeX-боксы имеют ширину, высоту и глубину, в отличие от Type1 и TrueType, которые используют полную ограничивающую рамку и продвижение по оси x. Метрики необходимо преобразовать в TeX-модель, а продвижение (если оно отличается от ширины) необходимо преобразовать в узел Kern, когда Char добавляется к родительскому узлу Hlist.

get_kerning(self, next) [исходный код]

Возвращает величину кернинга между этим и заданным символом.

Этот метод вызывается, когда символы объединяются в Hlist для создания узлов Kern.

grow(self) [исходный код]

Увеличивает размер на один уровень. Нет ограничений на максимальный размер.

is_slanted(self) [исходный код]
render(self, x, y) [исходный код]

Отображает символ на холсте

shrink(self) [исходный код]

Уменьшает размер на один уровень. Существует только три уровня уменьшения размера, после чего дальнейшее уменьшение невозможно.

class matplotlib.mathtext.ComputerModernFontConstants [исходный код]

Базовые классы: matplotlib.mathtext.FontConstantsBase

delta = 0.075
delta_integral = 0.3
delta_slanted = 0.3
script_space = 0.075
sub1 = 0.2
sub2 = 0.3
subdrop = 0.2
sup1 = 0.45
class matplotlib.mathtext.DejaVuFonts(*args, **kwargs) [исходный код]

Базовые классы: matplotlib.mathtext.UnicodeFonts

Параметры:
default_font_prop: `~.font_manager.FontProperties`

Стандартный шрифт, не используемый для математических символов, или базовый шрифт для рендеринга символов Юникода (общий).

mathtext_backend: `MathtextBackend` subclass

Подсистема, к которой фактически делегируется рендеринг.

use_cmex = False
class matplotlib.mathtext.DejaVuSansFontConstants [исходный код]

Базовые классы: matplotlib.mathtext.FontConstantsBase

class matplotlib.mathtext.DejaVuSansFonts(*args, **kwargs) [исходный код]

Базовые классы: matplotlib.mathtext.DejaVuFonts

Класс обработки шрифтов DejaVu Sans

Если глиф не найден, он переходит к Stix Sans

Параметры:
default_font_prop: `~.font_manager.FontProperties`

Стандартный шрифт без математических символов или базовый шрифт для рендеринга Unicode (обобщённый).

mathtext_backend: `MathtextBackend` subclass

Бэкенд, которому фактически делегируется рендеринг.

class matplotlib.mathtext.DejaVuSerifFontConstants [исходный код]

Базовые классы: matplotlib.mathtext.FontConstantsBase

class matplotlib.mathtext.DejaVuSerifFonts(*args, **kwargs) [исходный код]

Базовые классы: matplotlib.mathtext.DejaVuFonts

Класс обработки шрифтов DejaVu Serif

Если глиф не найден, он переходит к Stix Serif

Параметры:
default_font_prop: `~.font_manager.FontProperties`

Стандартный шрифт без математических символов или базовый шрифт для рендеринга Unicode (обобщённый).

mathtext_backend: `MathtextBackend` subclass

Бэкенд, которому фактически делегируется рендеринг.

matplotlib.mathtext.Error(msg) [исходный код]

Вспомогательный класс для повышения ошибок парсера.

class matplotlib.mathtext.Fil(**kwargs) [исходный код]

Базовые классы: matplotlib.mathtext.Glue

[Устарело]

Примечания

Устарело начиная с версии 3.3:

class matplotlib.mathtext.Fill(**kwargs) [исходный код]

Базовые классы: matplotlib.mathtext.Glue

[Устарело]

Примечания

Устарело начиная с версии 3.3:

class matplotlib.mathtext.Filll(**kwargs) [исходный код]

Базовые классы: matplotlib.mathtext.Glue

[Устарело]

Примечания

Устарело начиная с версии 3.3:

class matplotlib.mathtext.FontConstantsBase [исходный код]

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

Набор констант, управляющих расположением таких элементов, как нижние и верхние индексы. Все это метрики, которые нельзя надёжно получить из метрик шрифта самого шрифта.

delta = 0.025
delta_integral = 0.1
delta_slanted = 0.2
script_space = 0.05
sub1 = 0.3
sub2 = 0.5
subdrop = 0.4
sup1 = 0.7
class matplotlib.mathtext.Fonts(default_font_prop, mathtext_backend) [исходный код]

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

Абстрактный базовый класс для системы шрифтов, используемых для mathtext.

Класс должен уметь принимать ключи символов и имена файлов шрифтов и возвращать метрики символов. Он также делегирует фактическое отображение классу бэкенда.

Параметры:
default_font_prop: `~.font_manager.FontProperties`

Шрифт по умолчанию без математических символов или базовый шрифт для отображения символов Unicode (общих шрифтов).

mathtext_backend: подкласс `MathtextBackend`

Бэкенд, которому фактически делегируется отображение.

destroy(self) [исходный код]

Исправить все циклические ссылки перед уничтожением объекта.

get_kern(self, font1, fontclass1, sym1, fontsize1, font2, fontclass2, sym2, fontsize2, dpi) [исходный код]

Получить расстояние кернинга шрифта между sym1 и sym2.

fontX: одно из имён шрифтов TeX:

tt, it, rm, cal, sf, bf or default/regular (non-math)

fontclassX: TODO

symX: символ в исходном формате TeX. Например, '1', 'x' или 'sigma'

fontsizeX: размер шрифта в пунктах

dpi: текущее разрешение в точках на дюйм

get_metrics(self, font, font_class, sym, fontsize, dpi, math=True) [исходный код]

font: одно из имён шрифтов TeX:

tt, it, rm, cal, sf, bf or default/regular (non-math)

font_class: TODO

sym: символ в исходном формате TeX. Например, '1', 'x' или 'sigma'

fontsize: размер шрифта в пунктах

dpi: текущее разрешение в точках на дюйм

math: является ли sym математическим символом

Возвращает объект со следующими атрибутами:

  • advance: расстояние продвижения (в пунктах) глифа.
  • height: высота глифа в пунктах.
  • width: ширина глифа в пунктах.
  • xmin, xmax, ymin, ymax — прямоугольник чернил глифа
  • iceberg — расстояние от базовой линии до верхней части глифа. Это соответствует определению «высота» в TeX.
get_results(self, box) [исходный код]

Получить данные, необходимые бэкенду для отображения математического выражения. Возвращаемое значение зависит от бэкенда.

get_sized_alternatives_for_symbol(self, fontname, sym) [исходный код]

Переопределите этот метод, если ваш шрифт предоставляет несколько размеров одного и того же символа. Метод должен возвращать список символов, соответствующих sym в различных размерах. Генератор выражений выберет из этого списка наиболее подходящий размер для данной ситуации.

get_underline_thickness(self, font, fontsize, dpi) [исходный код]

Получить толщину линии, соответствующую данному шрифту. Используется в качестве базовой единицы для рисования линий, например, в дроби или радикале.

get_used_characters(self) [исходный код]

Получить набор символов, использованных в математическом выражении. Используется бэкендами, которым требуется подмножество шрифтов, чтобы определить, какие глифы включать.

get_xheight(self, font, fontsize, dpi) [исходный код]

Получить высоту строчной буквы x для данного font и fontsize.

render_glyph(self, ox, oy, facename, font_class, sym, fontsize, dpi) [исходный код]

Отобразить глиф в

  • ox, oy: позиция
  • facename: одно из имён шрифтов TeX
  • font_class:
  • sym: имя символа TeX или одиночный символ
  • fontsize: размер шрифта в пунктах
  • dpi: разрешение для отображения.
render_rect_filled(self, x1, y1, x2, y2) [исходный код]

Отобразить заполненный прямоугольник от (x1, y1) до (x2, y2).

set_canvas_size(self, w, h, d) [исходный код]

Установить размер буфера, используемого для отображения математического выражения. Необходимо только для растровых бэкендов.

class matplotlib.mathtext.Glue(glue_type, copy=<deprecated parameter>) [исходный код]

Базовые классы: matplotlib.mathtext.Node

Большая часть информации в этом объекте хранится в базовом классе _GlueSpec, который совместно используется несколькими объектами glue. (Это оптимизация памяти, которая, вероятно, больше не важна, но проще придерживаться того, что делает TeX.)

property glue_subtype
grow(self) [исходный код]

Увеличивается на один уровень. Размер ничем не ограничен.

shrink(self) [исходный код]

Уменьшается на один уровень. Существует только три уровня размеров, после чего объекты больше не уменьшаются.

class matplotlib.mathtext.GlueSpec(**kwargs) [исходный код]

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

[Устарело] См. Glue.

Примечания

Устарело начиная с версии 3.3.

copy(self) [исходный код]
classmethod factory(glue_type) [исходный код]
class matplotlib.mathtext.HCentered(elements) [исходный код]

Базовые классы: matplotlib.mathtext.Hlist

Класс-обёртка для создания Hlist, содержимое которого центрировано внутри его ограничивающей рамки.

class matplotlib.mathtext.Hbox(width) [исходный код]

Базовые классы: matplotlib.mathtext.Box

Прямоугольник с шириной (нулевая высота и глубина).

class matplotlib.mathtext.Hlist(elements, w=0.0, m='additional', do_kern=True) [исходный код]

Базовые классы: matplotlib.mathtext.List

Горизонтальный список ящиков.

hpack(self, w=0.0, m='additional') [исходный код]

Вычисление размеров результирующих ящиков и корректировка отступов, если один из этих размеров задан заранее. Вычисленные размеры обычно охватывают весь материал внутри нового ящика, но некоторые элементы могут выступать за его границы, если используется отрицательный отступ, ящик переполнен или \vbox включает другие ящики, сдвинутые влево.

Параметры:
wfloat, default: 0

Ширина.

m{'exactly', 'additional'}, default: 'additional'

Определяет, будет ли создан ящик шириной «точно» w или ящик с естественной шириной содержимого плюс w («дополнительный»).

Примечания

По умолчанию создаётся ящик с естественной шириной содержимого.

kern(self) [исходный код]

Вставка узлов Kern между узлами Char для установки кернинга.

Узлы Char сами определяют требуемое значение кернинга (в get_kerning), а эта функция просто создает правильный связанный список.

class matplotlib.mathtext.Hrule(state, thickness=None) [исходный код]

Базовые классы: matplotlib.mathtext.Rule

Удобный класс для создания горизонтальной линии.

class matplotlib.mathtext.Kern(width) [исходный код]

Базовые классы: matplotlib.mathtext.Node

Узел Kern имеет поле ширины, задающее (обычно отрицательное) значение отступа. Эта корректировка отступа появляется в горизонтальных списках между буквами, например A и V, когда дизайнер шрифта решил, что они выглядят лучше, если их сдвинуть ближе или дальше друг от друга. Узел кернинга также может появляться в вертикальном списке, где его ширина обозначает дополнительный отступ в вертикальном направлении.

depth = 0
grow(self) [исходный код]

Увеличение размера на один уровень. Максимальный размер не ограничен.

height = 0
shrink(self) [исходный код]

Уменьшение размера на один уровень. Существует только три уровня размеров, после чего дальнейшее уменьшение невозможно.

class matplotlib.mathtext.List(elements) [исходный код]

Базовые классы: matplotlib.mathtext.Box

Список узлов (горизонтальный или вертикальный).

grow(self) [исходный код]

Увеличение размера на один уровень. Максимальный размер не ограничен.

shrink(self) [исходный код]

Уменьшение размера на один уровень. Существует только три уровня размеров, после чего дальнейшее уменьшение невозможно.

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

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

Создаёт MathTextParser для заданного выходного бэкенда.

get_depth(self, texstr, dpi=120, fontsize=14) [исходный код]
Параметры:
texstrstr

Корректная строка mathtext, например r'IQ: $sigma_i=15$'.

dpifloat

Настройка точек на дюйм, используемая для отображения текста.

Возвращает:
int

Смещение базовой линии от нижнего края изображения в пикселях.

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

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

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

to_mask(self, texstr, dpi=120, fontsize=14) [исходный код]
Параметры:
texstrstr

Корректная строка mathtext, например r'IQ: $sigma_i=15$'.

dpifloat

Настройка точек на дюйм, используемая для отображения текста.

fontsizeint

Размер шрифта в пунктах

Возвращает:
array2D uint8 alpha

Маска растрового массива tex.

depthint

Смещение базовой линии от нижнего края изображения в пикселях.

to_png(self, filename, texstr, color='black', dpi=120, fontsize=14) [исходный код]

Отображает выражение TeX в файл PNG.

Параметры:
filename

Путь для записи или файловый объект.

texstrstr

Корректная строка mathtext, например r'IQ: $sigma_i=15$'.

colorcolor

Цвет текста.

dpifloat

Настройка точек на дюйм, используемая для отображения текста.

fontsizeint

Размер шрифта в пунктах.

Возвращает:
int

Смещение базовой линии от нижнего края изображения в пикселях.

to_rgba(self, texstr, color='black', dpi=120, fontsize=14) [исходный код]
Параметры:
texstrstr

Корректная строка mathtext, например r'IQ: $sigma_i=15$'.

colorcolor

Цвет текста.

dpifloat

Настройка точек на дюйм, используемая для отображения текста.

fontsizeint

Размер шрифта в пунктах.

Возвращает:
array(M, N, 4) array

Значения цвета RGBA для растрового tex, окрашенного с помощью color.

depthint

Смещение базовой линии от нижнего края изображения в пикселях.

exception matplotlib.mathtext.MathTextWarning [исходный код]

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

class matplotlib.mathtext.MathtextBackend [исходный код]

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

Базовый класс для кода mathtext, специфичного для бэкенда. Подклассы MathtextBackend обеспечивают интерфейс между mathtext и конкретными графическими бэкендами Matplotlib.

Подклассы должны переопределять следующие методы:

  • render_glyph()
  • render_rect_filled()
  • get_results()

А также, при необходимости, если требуется использовать стиль подсказок FreeType:

  • get_hinting_type()
get_hinting_type(self) [исходный код]

Получить тип подсказок FreeType для использования с этим конкретным бэкендом.

get_results(self, box) [исходный код]

Возвращает кортеж, специфичный для бэкенда, который передаётся бэкенду после завершения всей обработки.

render_glyph(self, ox, oy, info) [исходный код]

Отобразить глиф, описанный в info, в точке отсчёта (ox, oy).

render_rect_filled(self, x1, y1, x2, y2) [исходный код]

Отобразить заполненный чёрный прямоугольник от (x1, y1) до (x2, y2).

set_canvas_size(self, w, h, d) [исходный код]

Установить размер холста для рисования.

class matplotlib.mathtext.MathtextBackendAgg [исходный код]

Базовые классы: matplotlib.mathtext.MathtextBackend

Отображает глифы и прямоугольники в буфере FTImage, который затем передаётся бэкенду изображений Agg.

get_hinting_type(self) [исходный код]

Получить тип подсказок FreeType для использования с этим бэкендом.

get_results(self, box, used_characters) [исходный код]

Возвращает кортеж, специфичный для бэкенда, который передаётся бэкенду после завершения всех операций.

render_glyph(self, ox, oy, info) [исходный код]

Отображает глиф, описанный в info, в точке отсчёта (ox, oy).

render_rect_filled(self, x1, y1, x2, y2) [исходный код]

Отобразить заполненный чёрный прямоугольник от (x1, y1) до (x2, y2).

set_canvas_size(self, w, h, d) [исходный код]

Установить размеры холста для отображения.

class matplotlib.mathtext.MathtextBackendBitmap [исходный код]

Базовые классы: matplotlib.mathtext.MathtextBackendAgg

get_results(self, box, used_characters) [исходный код]

Возвращает кортеж, специфичный для бэкенда, который передаётся бэкенду после завершения всех операций.

class matplotlib.mathtext.MathtextBackendCairo [исходный код]

Базовые классы: matplotlib.mathtext.MathtextBackend

Сохраняет информацию для записи отрисовки mathtext в бэкенд Cairo.

get_results(self, box, used_characters) [исходный код]

Возвращает кортеж, специфичный для бэкэнда, для возврата бэкэнду после завершения всех операций.

render_glyph(self, ox, oy, info) [исходный код]

Отображает глиф, описанный в info, в точке отсчёта (ox, oy).

render_rect_filled(self, x1, y1, x2, y2) [исходный код]

Отрисовать заполненный чёрный прямоугольник от (x1, y1) до (x2, y2).

class matplotlib.mathtext.MathtextBackendPath [исходный код]

Базовые классы: matplotlib.mathtext.MathtextBackend

Сохраняет информацию для записи отрисовки mathtext в механизм путей текста.

get_results(self, box, used_characters) [исходный код]

Возвращает кортеж, специфичный для бэкэнда, для возврата бэкэнду после завершения всех операций.

render_glyph(self, ox, oy, info) [исходный код]

Отображает глиф, описанный в info, в точке отсчёта (ox, oy).

render_rect_filled(self, x1, y1, x2, y2) [исходный код]

Отрисовать заполненный чёрный прямоугольник от (x1, y1) до (x2, y2).

class matplotlib.mathtext.MathtextBackendPdf [исходный код]

Базовые классы: matplotlib.mathtext.MathtextBackend

Сохраняет информацию для записи отрисовки mathtext в бэкенд PDF.

get_results(self, box, used_characters) [исходный код]

Возвращает кортеж, специфичный для бэкэнда, для возврата бэкэнду после завершения всех операций.

render_glyph(self, ox, oy, info) [исходный код]

Отображает глиф, описанный в info, в точке отсчёта (ox, oy).

render_rect_filled(self, x1, y1, x2, y2) [исходный код]

Отрисовать заполненный чёрный прямоугольник от (x1, y1) до (x2, y2).

class matplotlib.mathtext.MathtextBackendPs [исходный код]

Базовые классы: matplotlib.mathtext.MathtextBackend

Сохраняет информацию для записи отрисовки mathtext в бэкенд PostScript.

get_results(self, box, used_characters) [исходный код]

Возвращает кортеж, специфичный для бэкэнда, для возврата бэкэнду после завершения всех операций.

render_glyph(self, ox, oy, info) [исходный код]

Отображает глиф, описанный в info, в точке отсчёта (ox, oy).

render_rect_filled(self, x1, y1, x2, y2) [исходный код]

Отрисовать заполненный чёрный прямоугольник от (x1, y1) до (x2, y2).

class matplotlib.mathtext.MathtextBackendSvg [исходный код]

Базовые классы: matplotlib.mathtext.MathtextBackend

Хранит информацию для отрисовки математического текста в формате SVG.

get_results(self, box, used_characters) [исходный код]

Возвращает кортеж, специфичный для бэкенда, который будет возвращён бэкенду после завершения всех операций.

render_glyph(self, ox, oy, info) [исходный код]

Отрисовывает глиф, описанный в info, в точку с координатами (ox, oy).

render_rect_filled(self, x1, y1, x2, y2) [исходный код]

Отрисовывает заполненный чёрный прямоугольник от точки (x1, y1) до точки (x2, y2).

class matplotlib.mathtext.NegFil(**kwargs) [исходный код]

Базовые классы: matplotlib.mathtext.Glue

[Устарело]

Примечания

Устарело начиная с версии 3.3:

class matplotlib.mathtext.NegFill(**kwargs) [исходный код]

Базовые классы: matplotlib.mathtext.Glue

[Устарело]

Примечания

Устарело начиная с версии 3.3:

class matplotlib.mathtext.NegFilll(**kwargs) [исходный код]

Базовые классы: matplotlib.mathtext.Glue

[Устарело]

Примечания

Устарело начиная с версии 3.3:

class matplotlib.mathtext.Node [исходный код]

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

Узел в модели TeX-блока.

get_kerning(self, next) [исходный код]
grow(self) [исходный код]

Увеличивает размер на один уровень. Размер может увеличиваться без ограничений.

render(self, x, y) [исходный код]
shrink(self) [исходный код]

Уменьшает размер на один уровень. Есть всего три уровня уменьшения размера, после чего размер больше не уменьшается.

END_OF_DOCUMENT_MARKER
class matplotlib.mathtext.Parser [исходный код]

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

Парсер на основе pyparsing для строк, содержащих математические выражения.

Необработанный текст также может появляться вне пар пар $.

Грамматика основана непосредственно на грамматике TeX, хотя некоторые упрощения сделаны.

class State(font_output, font, font_class, fontsize, dpi) [исходный код]

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

Хранит состояние парсера.

Состояния помещаются и извлекаются из стека по мере необходимости, и "текущее" состояние всегда находится вверху стека.

copy(self) [исходный код]
property font
accent(self, s, loc, toks) [исходный код]
accentprefixed(self, s, loc, toks)
auto_delim(self, s, loc, toks) [исходный код]
binom(self, s, loc, toks) [исходный код]
c_over_c(self, s, loc, toks) [исходный код]
customspace(self, s, loc, toks) [исходный код]
dfrac(self, s, loc, toks) [исходный код]
end_group(self, s, loc, toks) [исходный код]
font(self, s, loc, toks) [исходный код]
frac(self, s, loc, toks) [исходный код]
function(self, s, loc, toks) [исходный код]
genfrac(self, s, loc, toks) [исходный код]
get_state(self) [исходный код]

Получить текущее состояние State парсера.

group(self, s, loc, toks) [исходный код]
is_between_brackets(self, s, loc) [исходный код]
is_dropsub(self, nucleus) [исходный код]
is_overunder(self, nucleus) [исходный код]
is_slanted(self, nucleus) [исходный код]
main(self, s, loc, toks) [исходный код]
math(self, s, loc, toks) [исходный код]
math_string(self, s, loc, toks) [исходный код]
non_math(self, s, loc, toks) [исходный код]
operatorname(self, s, loc, toks) [исходный код]
overline(self, s, loc, toks) [исходный код]
parse(self, s, fonts_object, fontsize, dpi) [исходный код]

Разбирает выражение s, используя заданный объект шрифтов fonts_object для вывода при указанном fontsize и dpi.

Возвращает дерево разбора из экземпляров Node.

pop_state(self) [исходный код]

Извлечь состояние State из стека.

push_state(self) [исходный код]

Поместить новое состояние State в стек, скопировав текущее состояние.

required_group(self, s, loc, toks)
simple_group(self, s, loc, toks)
space(self, s, loc, toks) [исходный код]
sqrt(self, s, loc, toks) [исходный код]
start_group(self, s, loc, toks) [исходный код]
subsuper(self, s, loc, toks) [исходный код]
symbol(self, s, loc, toks) [исходный код]
unknown_symbol(self, s, loc, toks) [исходный код]
class matplotlib.mathtext.Rule(width, height, depth, state) [исходный код]

Базовый класс: matplotlib.mathtext.Box

Прямоугольник тёмно-чёрного цвета.

У него есть поля width, depth и height, как и в Hlist. Однако, если любое из этих размеров равно inf, фактическое значение будет определяться выполнением правила до границы самого внутреннего ограничивающего прямоугольника. Это называется «переменным размером». Ширина никогда не является переменной в Hlist; высота и глубина никогда не являются переменными в Vlist.

render(self, x, y, w, h) [исходный код]
class matplotlib.mathtext.STIXFontConstants [исходный код]

Базовый класс: matplotlib.mathtext.FontConstantsBase

delta = 0.05
delta_integral = 0.3
delta_slanted = 0.3
script_space = 0.1
sub2 = 0.6
sup1 = 0.8
class matplotlib.mathtext.STIXSansFontConstants [исходный код]

Базовый класс: matplotlib.mathtext.FontConstantsBase

delta_integral = 0.3
delta_slanted = 0.6
script_space = 0.05
sup1 = 0.8
class matplotlib.mathtext.Ship [исходный код]

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

Вывод ящиков, предназначенных для вывода, после их настройки, отправляет их на вывод.

Поскольку ящики могут находиться внутри ящиков внутри ящиков, основная работа Ship выполняется двумя взаимно рекурсивными процедурами, hlist_out и vlist_out, которые обходят узлы Hlist и узлы Vlist внутри горизонтальных и вертикальных ящиков. Глобальные переменные, используемые в TeX для хранения состояния при обработке, здесь стали переменными-членами.

static clamp(value) [исходный код]
hlist_out(self, box) [исходный код]
vlist_out(self, box) [исходный код]
class matplotlib.mathtext.SsGlue(**kwargs) [исходный код]

Базовый класс: matplotlib.mathtext.Glue

[Устарело]

Примечания

Устарело начиная с версии 3.3:

class matplotlib.mathtext.StandardPsFonts(default_font_prop) [исходный код]

Базовый класс: matplotlib.mathtext.Fonts

Используйте стандартные шрифты PostScript для рендеринга в backend_ps

В отличие от других классов шрифтов, BakomaFont и UnicodeFont, этот класс требует бэкенд Ps.

Параметры:
default_font_prop: `~.font_manager.FontProperties`

Стандартный шрифт без математических символов или базовый шрифт для рендеринга шрифтов Unicode (общий).

mathtext_backend: `MathtextBackend` подкласс

Бэкенд, которому фактически делегирован рендеринг.

basepath = '/usr/local/lib64/python3.8/site-packages/matplotlib/mpl-data/fonts/afm'
fontmap = {'cal': 'pzcmi8a', 'rm': 'pncr8a', 'tt': 'pcrr8a', 'it': 'pncri8a', 'sf': 'phvr8a', 'bf': 'pncb8a', None: 'psyr'}
get_kern(self, font1, fontclass1, sym1, fontsize1, font2, fontclass2, sym2, fontsize2, dpi) [исходный код]

Получение расстояния кернинга между символами sym1 и sym2 в шрифте.

fontX: одно из имён шрифтов TeX:

tt, it, rm, cal, sf, bf or default/regular (non-math)

fontclassX: TODO

symX: символ в сыром формате TeX. Например, '1', 'x' или 'sigma'

fontsizeX: размер шрифта в пунктах

dpi: текущее значение точек на дюйм

get_underline_thickness(self, font, fontsize, dpi) [исходный код]

Получение толщины линии, соответствующей данному шрифту. Используется в качестве базовой единицы для рисования линий, таких как в дроби или радикале.

get_xheight(self, font, fontsize, dpi) [исходный код]

Получение высоты строчной буквы x для данного font и fontsize.

class matplotlib.mathtext.StixFonts(*args, **kwargs) [исходный код]

Базовый класс: matplotlib.mathtext.UnicodeFonts

Класс для обработки шрифтов STIX.

В дополнение к тому, что предоставляет UnicodeFonts, этот класс:

  • поддерживает «виртуальные шрифты», которые представляют собой полные наборы букв и цифр с различными стилями шрифтов в особых кодах Unicode, таких как «Чёрный».
  • обрабатывает альтернативные символы разных размеров для шрифтов STIXSizeX.
Параметры:
default_font_prop: `~.font_manager.FontProperties`

Стандартный шрифт без математических символов или базовый шрифт для рендеринга шрифтов Unicode (общий).

mathtext_backend: `MathtextBackend` подкласс

Бэкенд, которому фактически делегирован рендеринг.

cm_fallback = False
get_sized_alternatives_for_symbol(self, fontname, sym) [исходный код]

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

use_cmex = False
END_OF_DOCUMENT_MARKER
class matplotlib.mathtext.StixSansFonts(*args, **kwargs) [исходный код]

Базовые классы: matplotlib.mathtext.StixFonts

Класс обработки шрифтов STIX (по умолчанию использует шрифты без засечек).

Параметры:
default_font_prop: `~.font_manager.FontProperties`

Стандартный шрифт без математических символов или базовый шрифт для рендеринга символов Юникода (универсальный).

mathtext_backend: `MathtextBackend` подкласс

Подкласс, которому фактически делегируется рендеринг.

class matplotlib.mathtext.SubSuperCluster [исходный код]

Базовые классы: matplotlib.mathtext.Hlist

Обходное решение, связанное с тем, что этот код выполняет двухпроходный анализ, подобно TeX. Это позволяет нам хранить достаточную информацию в самом hlist, а именно ядро, нижний и верхний индексы, чтобы при добавлении следующего индекса его можно было переконфигурировать на лету.

class matplotlib.mathtext.TruetypeFonts(default_font_prop, mathtext_backend) [исходный код]

Базовые классы: matplotlib.mathtext.Fonts

Общий базовый класс для всех настроек шрифтов, использующих шрифты TrueType (через FT2Font).

Параметры:
default_font_prop: `~.font_manager.FontProperties`

Стандартный шрифт без математических символов или базовый шрифт для рендеринга символов Юникода (универсальный).

mathtext_backend: `MathtextBackend` подкласс

Подкласс, которому фактически делегируется рендеринг.

destroy(self) [исходный код]

Исправление циклических ссылок перед уничтожением объекта.

get_kern(self, font1, fontclass1, sym1, fontsize1, font2, fontclass2, sym2, fontsize2, dpi) [исходный код]

Получение расстояния кернинга для шрифта между sym1 и sym2.

fontX: одно из имён шрифтов TeX:

tt, it, rm, cal, sf, bf or default/regular (non-math)

fontclassX: TODO

symX: символ в формате TeX. Например, '1', 'x' или 'sigma'

fontsizeX: размер шрифта в пунктах

dpi: текущее значение точек на дюйм

get_underline_thickness(self, font, fontsize, dpi) [исходный код]

Получение толщины подчеркивания, соответствующей данному шрифту. Используется в качестве базовой единицы для рисования линий, например, в дроби или радикале.

get_xheight(self, fontname, fontsize, dpi) [исходный код]

Получение высоты строчной буквы x для данного font и fontsize.

class matplotlib.mathtext.UnicodeFonts(*args, **kwargs) [исходный код]

Базовые классы: matplotlib.mathtext.TruetypeFonts

Абстрактный базовый класс для обработки шрифтов Юникода.

Хотя некоторые достаточно полные шрифты Юникода (такие как DejaVu) могут работать в некоторых ситуациях, единственный шрифт Юникода, о котором мне известно, имеющий полный набор математических символов, это STIX.

Этот класс будет использовать шрифты Bakoma по умолчанию, когда необходимый символ не найден в шрифте.

Параметры:
default_font_prop: `~.font_manager.FontProperties`

Стандартный шрифт без математических символов или базовый шрифт для рендеринга символов Юникода (универсальный).

mathtext_backend: `MathtextBackend` подкласс

Подкласс, которому фактически делегируется рендеринг.

get_sized_alternatives_for_symbol(self, fontname, sym) [исходный код]

Переопределить, если ваш шрифт предоставляет несколько размеров одного и того же символа. Должен вернуть список символов, соответствующих sym в различных размерах. Рендерер выражений выберет наиболее подходящий размер из этого списка в данной ситуации.

use_cmex = True
class matplotlib.mathtext.VCentered(elements) [исходный код]

Базовые классы: matplotlib.mathtext.Vlist

Класс-обёртка для создания Vlist с центрированным содержимым внутри его ограничительной области.

class matplotlib.mathtext.Vbox(height, depth) [исходный код]

Базовые классы: matplotlib.mathtext.Box

Прямоугольник с высотой (ширина равна нулю).

class matplotlib.mathtext.Vlist(elements, h=0.0, m='additional') [исходный код]

Базовые классы: matplotlib.mathtext.List

Вертикальный список прямоугольников.

vpack(self, h=0.0, m='additional', l=inf) [исходный код]

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

Параметры:
hfloat, default: 0

Высота.

m{'exactly', 'additional'}, default: 'additional'

Определить, должен ли прямоугольник иметь ровно заданную высоту w или высоту, равную естественной высоте содержимого плюс w (дополнительная).

lfloat, default: np.inf

Максимальная высота.

Примечания

По умолчанию создаётся прямоугольник с естественной высотой содержимого.

class matplotlib.mathtext.Vrule(state) [исходный код]

Базовые классы: matplotlib.mathtext.Rule

Класс-обёртка для создания вертикальной линии.

matplotlib.mathtext.get_unicode_index(symbol, math=True) [исходный код]

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

Параметры:
symbolstr

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

mathbool, default: True

Если False, всегда обрабатывать как один символ Юникода.

END_OF_DOCUMENT_MARKER
matplotlib.mathtext.math_to_image(s, filename_or_obj, prop=None, dpi=None, format=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.

© 2012–2018 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/3.3.3/api/mathtext_api.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API