matplotlib.backends.backend_pgf

matplotlib.backends.backend_pgf.FigureCanvas

alias of matplotlib.backends.backend_pgf.FigureCanvasPgf

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

Bases: matplotlib.backend_bases.FigureCanvasBase

draw()[source]

Отобразить Figure.

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

filetypes = {'pdf': 'LaTeX скомпилированная PGF картинка', 'pgf': 'LaTeX PGF картинка', 'png': 'Portable Network Graphics'}

get_default_filetype()[source]

Возвращает формат файла сохранения по умолчанию, как указано в rcParams["savefig.format"] (по умолчанию: 'png').

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

get_renderer()[source]

print_pdf(fname_or_fh, *args, metadata=None, **kwargs)[source]

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

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

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

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

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

class matplotlib.backends.backend_pgf.GraphicsContextPgf[source]

Bases: matplotlib.backend_bases.GraphicsContextBase

[Устарело]

Примечания

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

исключение matplotlib.backends.backend_pgf.LatexError(message, latex_output='')[source]

Bases: Exception

class matplotlib.backends.backend_pgf.LatexManager[source]

Bases: object

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

get_width_height_descent(text, prop)[source]

Получение ширины, общей высоты и спуска для текста, форматированного текущей средой LaTeX.

latex_stdin_utf8()[source]

[Устарело]

Примечания

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

класс matplotlib.backends.backend_pgf.PdfPages(filename, *, keep_empty=True, metadata=None)[source]

Основы: object

Многостраничный PDF-файл, использующий backend 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строка или объект пути Графики, использующие PdfPages.savefig, будут записаны в файл по этому расположению. Любой более старый файл с таким же именем будет перезаписан. keep_emptybool, по умолчанию: True Если установлено в False, пустые PDF-файлы будут автоматически удалены при закрытии. metadataсловарь, необязательно Объект словаря информации (см. раздел 10.2.1 «Словарь информации документа» справочника PDF), например: {'Creator': 'My software', 'Author': 'Me', 'Title': 'Awesome'}. Стандартные ключи — 'Title', 'Author', 'Subject', 'Keywords', 'Creator', 'Producer', 'CreationDate', 'ModDate' и 'Trapped'. Значения для 'Creator', 'Producer' и 'CreationDate' были предварительно определены. Их можно удалить, установив их в None. Обратите внимание, что некоторые версии движков LaTeX могут игнорировать ключ 'Producer' и установить его самим собой.

close()[source]

Завершение работы с этим объектом, выполнение LaTeX в временной папке и перемещение итогового PDF-файла в filename.

get_pagecount()[source]

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

keep_empty

свойство metadata

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

Сохранение Figure в этот файл в качестве новой страницы.

Все другие ключевые аргументы передаются в savefig.

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

класс matplotlib.backends.backend_pgf.RendererPgf(figure, fh, dummy=<deprecated parameter>)[source]

Bases: matplotlib.backend_bases.RendererBase

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

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

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

Отобразить изображение RGBA.

Параметры:

gcGraphicsContextBase Контекст графики с информацией о обрезке. xскаляр Расстояние в физических единицах (т.е. точках или пикселях) от левой стороны холста. yскаляр Расстояние в физических единицах (т.е. точках или пикселях) от нижней стороны холста. im(N, M, 4) массив-подобный np.uint8 Массив пикселей RGBA. transformmatplotlib.transforms.Affine2DBase Если и только если конкретный бэкенд написан таким образом, что option_scale_image() возвращает True, может быть передано аффинное преобразование (т.е., Affine2DBase) возможно в draw_image(). Вектор смещения преобразования задается в физических единицах (т.е. точках или пикселях). Обратите внимание, что преобразование не переопределяет x и y и должно быть применено до преобразования результата на x и y (это можно сделать, добавив x и y к вектору смещения, определенному в transform).

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

Отобразить маркер в каждой вершине path (исключая контрольные точки).

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

Параметры:	gcGraphicsContextBase Контекст графики. marker_transmatplotlib.transforms.Transform Аффинное преобразование, применяемое к маркеру. transmatplotlib.transforms.Transform Аффинное преобразование, применяемое к пути.

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

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

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

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

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

Параметры:	gcGraphicsContextBase Контекст графики. xfloat Положение x текста в координатах отображения. yfloat Положение y базовой линии текста в координатах отображения. sstr Строка текста. propmatplotlib.font_manager.FontProperties Свойства шрифта. anglefloat Угол поворота в градусах против часовой стрелки. mtextmatplotlib.text.Text Исходный объект текста для отображения.

Примечания

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

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

if 0: bbox_artist(self, renderer)

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

flipy()[source]

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

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

get_canvas_width_height()[source]

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

get_text_width_height_descent(s, prop, ismath)[source]

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

option_image_nocomposite()[source]

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

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

option_scale_image()[source]

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

points_to_pixels(points)[source]

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

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

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

Параметры:	pointsfloat или массив-подобный тип значение с плавающей точкой или массив NumPy значений с плавающей точкой
Возвращает:	Точки, преобразованные в пиксели

class matplotlib.backends.backend_pgf.TmpDirCleaner(*args, **kwargs)[source]

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

[Устарело]

Примечания

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

статический add(tmpdir)[source]

[Устарело]

Примечания

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

статический cleanup_remaining_tmpdirs()[source]

[Устарело]

Примечания

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

remaining_tmpdirs = {}

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

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

Это различает текстовый и математический режимы, заменяя разделитель математических формул $ на \(\displaystyle %s\). Экранированные разделители математических формул (\$) игнорируются.

В текстовых фрагментах экранируются следующие символы: _^$%

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

Сгенерировать преамбулу fontspec из rc.

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

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

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

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

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