matplotlib.backends.backend_pgf

matplotlib.backends.backend_pgf.FigureCanvas

Псевдоним для matplotlib.backends.backend_pgf.FigureCanvasPgf

class matplotlib.backends.backend_pgf.FigureCanvasPgf(figure) [source]

Базовый класс: matplotlib.backend_bases.FigureCanvasBase

filetypes = {'pdf': 'LaTeX compiled PGF picture', 'pgf': 'LaTeX PGF picture', 'png': 'Portable Network Graphics'}

get_default_filetype(self) [source]

Возвращает стандартный формат сохранения файла, указанный в rcParam savefig.format. Возвращаемая строка исключает точку. Переопределено в бэкендах, которые поддерживают только один тип файла.

get_renderer(self) [source]

print_pdf(self, fname_or_fh, *args, **kwargs) [source]

Использует LaTeX для компиляции созданной с помощью Pgf фигуры в PDF.

print_pgf(self, fname_or_fh, *args, **kwargs) [source]

Вывод команд pgf для отрисовки фигуры, чтобы ее можно было включить и отобразить в документах LaTeX.

print_png(self, fname_or_fh, *args, **kwargs) [source]

Использует LaTeX для компиляции pgf фигуры в pdf и конвертирует ее в png.

matplotlib.backends.backend_pgf.FigureManager

Псевдоним для matplotlib.backends.backend_pgf.FigureManagerPgf

class matplotlib.backends.backend_pgf.FigureManagerPgf(canvas, num) [source]

Базовый класс: matplotlib.backend_bases.FigureManagerBase

class matplotlib.backends.backend_pgf.GraphicsContextPgf [source]

Базовый класс: matplotlib.backend_bases.GraphicsContextBase

exception matplotlib.backends.backend_pgf.LatexError(message, latex_output='') [source]

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

class matplotlib.backends.backend_pgf.LatexManager [source]

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

LatexManager открывает экземпляр приложения LaTeX для определения метрик элементов текста. Окружение LaTeX можно изменить, задав шрифты и/или пользовательский преамбулу в параметрах rc.

get_width_height_descent(self, text, prop) [source]

Возвращает ширину, общую высоту и спуск для текста, набранного текущей средой LaTeX.

class matplotlib.backends.backend_pgf.LatexManagerFactory(**kwargs) [source]

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

[Устаревшее]

Примечания

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

static get_latex_manager() [source]

previous_instance = None

class matplotlib.backends.backend_pgf.PdfPages(filename, *, keep_empty=True, metadata=None) [source]

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

Многостраничный PDF-файл с использованием бэкенда pgf

Примеры

>>> import matplotlib.pyplot as plt
>>> # Initialize:
>>> with PdfPages('foo.pdf') as pdf:
...     # As many times as you like, create a figure fig and save it:
...     fig = plt.figure()
...     pdf.savefig(fig)
...     # When no figure is specified the current figure is saved
...     pdf.savefig()

Создание нового объекта PdfPages.

Параметры:

filename : str Графики, использующие PdfPages.savefig(), будут записаны в файл по этому пути. Любой более старый файл с таким же именем будет перезаписан. keep_empty : bool, optional Если установлено в значение False, то пустые pdf-файлы будут автоматически удалены при закрытии. metadata : dictionary, optional Объект словаря информации (см. раздел 10.2.1 «Словарь информации документа» справочника PDF), например: {'Creator': 'My software', 'Author': 'Me', 'Title': 'Awesome fig'} Стандартные ключи: 'Title', 'Author', 'Subject', 'Keywords', 'Producer', 'Creator' и 'Trapped'. Значения предопределены для 'Creator' и 'Producer'. Их можно удалить, установив их в пустую строку.

close(self) [source]

Закрытие объекта, выполнение LaTeX в временной директории и перемещение конечного pdf-файла в filename.

get_pagecount(self) [source]

Возвращает текущее количество страниц в многостраничном pdf-файле.

keep_empty

metadata

savefig(self, figure=None, **kwargs) [source]

Сохраняет Figure в этом файле в виде новой страницы.

Любые другие ключевые параметры передаются в savefig().

Параметры:	figure : Figure or int, optional Указывает, какая фигура сохраняется в файл. Если не указано, сохраняется активная фигура. Если предоставлен экземпляр Figure, сохраняется эта фигура. Если указано целое число, ищется экземпляр фигуры по номеру.

class matplotlib.backends.backend_pgf.RendererPgf(figure, fh, dummy=False) [source]

Bases: matplotlib.backend_bases.RendererBase

Создаёт новый рендерер PGF, который преобразует любые инструкции отрисовки в текстовые команды для интерпретации в среде latex pgfpicture.

Атрибуты:	figure : matplotlib.figure.Figure Объект Matplotlib figure для инициализации высоты, ширины и dpi. fh : file-like Дескриптор файла для вывода команд отрисовки.

draw_image(self, gc, x, y, im, transform=None) [source]

Отрисовка изображения RGBA.

Параметры:

gc : GraphicsContextBase Объект контекста графики с информацией о обрезке. x : scalar Расстояние в физических единицах (точках или пикселях) от левой стороны холста. y : scalar Расстояние в физических единицах (точках или пикселях) от нижней стороны холста. im : array_like, shape=(N, M, 4), dtype=np.uint8 Массив пикселей RGBA. transform : matplotlib.transforms.Affine2DBase Если и только если конкретный бэкенд написан таким образом, что option_scale_image() возвращает True, может быть передано аффинное преобразование draw_image(). Оно имеет вид экземпляра Affine2DBase. Вектор смещения преобразования задан в физических единицах (точках или пикселях). Обратите внимание, что преобразование не переопределяет x и y, и его необходимо применять *перед* преобразованием результата на x и y. (Это можно сделать, добавив x и y к вектору смещения, определенному transform).

draw_markers(self, gc, marker_path, marker_trans, path, trans, rgbFace=None) [source]

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

Это обеспечивает резервную реализацию draw_markers, которая делает несколько вызовов draw_path(). Некоторые бэкенды могут захотеть переопределить этот метод, чтобы нарисовать маркер только один раз и повторно использовать его несколько раз.

Параметры:	gc : GraphicsContextBase Контекст графики marker_trans : matplotlib.transforms.Transform Аффинное преобразование, применяемое к маркеру. trans : matplotlib.transforms.Transform Аффинное преобразование, применяемое к пути.

draw_path(self, gc, path, transform, rgbFace=None) [source]

Отрисовывает экземпляр Path с использованием заданного аффинного преобразования.

draw_tex(self, gc, x, y, s, prop, angle, ismath='TeX!', mtext=None) [source]

draw_text(self, gc, x, y, s, prop, angle, ismath=False, mtext=None) [source]

Отрисовывает экземпляр текста.

Параметры:	gc : GraphicsContextBase Контекст графики. x : scalar Координата x текста в координатах отображения. y : scalar Координата y базовой линии текста в координатах отображения. s : str Строка текста. prop : matplotlib.font_manager.FontProperties Свойства шрифта. angle : scalar Угол поворота в градусах. mtext : matplotlib.text.Text Исходный объект текста для отрисовки.

Примечания

Примечание для разработчиков бэкендов

Когда вы пытаетесь определить, правильно ли вы получили прямоугольник (что позволяет правильно работать с выкладкой/выравниванием текста), полезно изменить строку в text.py:

if 0: bbox_artist(self, renderer)

на if 1, и тогда прямоугольник будет нарисован вместе с текстом.

flipy(self) [source]

Возвращает, увеличиваются ли значения y сверху вниз.

Обратите внимание, что это влияет только на отрисовку текста и изображений.

get_canvas_width_height(self) [source]

Возвращает ширину и высоту холста в координатах отображения.

get_text_width_height_descent(self, s, prop, ismath) [source]

Получает ширину, высоту и нисходящую часть (смещение от нижней части до базовой линии) в координатах отображения строки s с FontProperties prop

new_gc(self) [source]

Возвращает экземпляр GraphicsContextBase.

option_image_nocomposite(self) [source]

Возвращает, следует ли пропустить композицию изображения Matplotlib.

Бэкенды растровых изображений обычно возвращают False (позволяя C-уровневому растрирующему устройству позаботиться о композиции изображения); бэкенды векторных изображений обычно возвращают not rcParams["image.composite_image"].

option_scale_image(self) [source]

Возвращает, поддерживаются ли произвольные аффинные преобразования в draw_image() (True для большинства векторных бэкендов).

points_to_pixels(self, points) [source]

Преобразует точки в единицы отображения.

Вам нужно переопределить эту функцию (если ваш бэкенд не имеет dpi, например, postscript или svg). Некоторые системы обработки изображений предполагают какое-то значение для пикселей на дюйм:

points to pixels = points * pixels_per_inch/72.0 * dpi/72.0

Параметры:	points : scalar or array_like число с плавающей точкой или массив numpy чисел с плавающей точкой
Возвращает:	Точки, преобразованные в пиксели

class matplotlib.backends.backend_pgf.TmpDirCleaner [source]

Базы: object

static add(tmpdir) [source]

static cleanup_remaining_tmpdirs() [source]

remaining_tmpdirs = {}

matplotlib.backends.backend_pgf.common_texification(text) [source]

Выполняет необходимые и/или полезные подстановки для текстов, которые должны быть включены в документы LaTeX.

matplotlib.backends.backend_pgf.get_fontspec() [source]

Создаёт преамбулу fontspec из rc.

matplotlib.backends.backend_pgf.get_preamble() [source]

Получает преамбулу LaTeX из rc.

matplotlib.backends.backend_pgf.get_texcommand() [source]

[Устарело] Получает выбранную систему TeX из rc.

Примечания

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

matplotlib.backends.backend_pgf.make_pdf_to_png_converter() [source]

Возвращает функцию, которая преобразует файл pdf в файл png.

matplotlib.backends.backend_pgf.repl_escapetext(m)

matplotlib.backends.backend_pgf.repl_mathdefault(m)

matplotlib.backends.backend_pgf.writeln(fh, line) [source]