matplotlib.backends.backend_pgf

matplotlib.backends.backend_pgf.FigureCanvas[source]

псевдоним FigureCanvasPgf

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

Базы: FigureCanvasBase

draw()[source]

Отображение Figure.

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

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

get_default_filetype()[source]

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

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

get_renderer()[source]

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

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

print_pgf(fname_or_fh, **kwargs)[source]

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

print_png(fname_or_fh, **kwargs)[source]

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

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

Базы: Exception

classmatplotlib.backends.backend_pgf.LatexManager[source]

Базы: object

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

get_width_height_descent(text, prop)[source]

Получить ширину, общую высоту и спуск (в пунктах TeX) для текста, набранного текущей средой LaTeX.

propertylatex_header[source]

[Устарело]

Примечания

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

propertytexcommand[source]

[Устарело]

Примечания

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

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

Bases: 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строка или путь

Графики, использующие 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

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

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

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

Параметры:

figureFigure или int, по умолчанию: активная фигура

Фигура или индекс фигуры, сохраняемой в файл.

classmatplotlib.backends.backend_pgf.RendererPgf(figure, fh)[source]

Bases: RendererBase

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

Атрибуты:

figureFigure

Фигура 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_path. Бэкэнды могут переопределить этот метод, чтобы нарисовать маркер только один раз и повторно использовать его несколько раз.

Параметры:

gcGraphicsContextBase

Контекст графики.

marker_transTransform

Аффинное преобразование, применяемое к маркерам.

transTransform

Аффинное преобразование, применяемое к пути.

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

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

draw_tex(gc, x, y, s, prop, angle, *, mtext=None)[source]

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

Параметры:

gcGraphicsContextBase

Контекст графики.

xfloat

Координата x текста в координатах отображения.

yfloat

Координата y базовой линии текста в координатах отображения.

sstr

Строка TeX текста.

propFontProperties

Свойства шрифта.

anglefloat

Угол поворота в градусах против часовой стрелки.

mtextText

Исходный объект текста для рендеринга.

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

Отрисовка текстового элемента.

Параметры:

gcGraphicsContextBase

Контекст графики.

xfloat

Координата x текста в координатах отображения.

yfloat

Координата y базовой линии текста в координатах отображения.

sstr

Строка текста.

propFontProperties

Свойства шрифта.

anglefloat

Угол поворота в градусах против часовой стрелки.

ismathbool или "TeX"

Если True, используется парсер mathtext. Если "TeX", используется tex для отрисовки.

mtextText

Исходный объект текста для отрисовки.

Примечания

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

При попытке определить, правильно ли рассчитана область обводки (что позволяет правильно выровнять и расположить текст), полезно изменить строку в файле 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 с плавающей точкой

Возвращает:

Точки, преобразованные в пиксели

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

[Устарело]

Примечания

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

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

[Устарело] Создание преамбулы fontspec из rc.

Примечания

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

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

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

Примечания

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

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

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

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

[Устарело]

Примечания

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