matplotlib.backends.backend_pgf

matplotlib.backends.backend_pgf.FigureCanvas[исходный код]: псевдоним для FigureCanvasPgf

classmatplotlib.backends.backend_pgf.FigureCanvasPgf(figure=None)[исходный код]

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

Выполняет отрисовку Figure.

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

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

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

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

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

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

print_pdf(fname_or_fh, *, metadata=None, **kwargs)[исходный код]: Использует LaTeX для компиляции созданного pgf-рисунка в pdf.

print_pgf(fname_or_fh, **kwargs)[исходный код]: Выводит макросы pgf для отрисовки рисунка, чтобы его можно было включить в документы LaTeX и отобразить в них.

print_png(fname_or_fh, **kwargs)[исходный код]: Использует LaTeX для компиляции рисунка pgf в pdf и преобразования его в png.

exceptionmatplotlib.backends.backend_pgf.LatexError(message, latex_output='')[исходный код]: Базовые классы: Exception

classmatplotlib.backends.backend_pgf.LatexManager[исходный код]

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

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

get_width_height_descent(text, prop)[исходный код]: Возвращает ширину, полную высоту и глубину (в пунктах TeX) текста, набранного в текущей среде LaTeX.

classmatplotlib.backends.backend_pgf.PdfPages(filename, *, metadata=None)[исходный код]

Базовые классы: 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.

Параметры:

filenamestr или объект, подобный пути

Графики, сохранённые с помощью PdfPages.savefig, будут записаны в файл по этому пути. Любой существующий файл с таким же именем будет перезаписан.

metadatadict, необязательный

Объект словаря с информацией (см. раздел 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()[исходный код]: Завершает работу этого объекта, запускает LaTeX во временной директории и перемещает итоговый pdf-файл в filename.

get_pagecount()[исходный код]: Возвращает текущее количество страниц в многостраничном pdf-файле.

savefig(figure=None, **kwargs)[исходный код]

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

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

Параметры:

figureFigure или int, по умолчанию: активный рисунок: Рисунок или его индекс, который сохраняется в файл.

classmatplotlib.backends.backend_pgf.RendererPgf(figure, fh)[исходный код]

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

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

Атрибуты:

figureFigure: Фигура Matplotlib, из которой берутся начальные значения высоты, ширины и dpi.
fhфайлоподобный объект: Дескриптор файла для вывода команд рисования.

draw_image(gc, x, y, im, transform=None)[исходный код]

Рисует изображение RGBA.

Параметры:

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

draw_markers(gc, marker_path, marker_trans, path, trans, rgbFace=None)[исходный код]

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

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

Параметры:

gcGraphicsContextBase: Графический контекст.
marker_pathPath: Путь маркера.
marker_transTransform: Аффинное преобразование, применяемое к маркеру.
pathPath: Места, в которых следует нарисовать маркеры.
transTransform: Аффинное преобразование, применяемое к пути.
rgbFaceцвет, необязательно

draw_path(gc, path, transform, rgbFace=None)[исходный код]: Рисует экземпляр Path с использованием заданного аффинного преобразования.

draw_tex(gc, x, y, s, prop, angle, *, mtext=None)[исходный код]

Рисует экземпляр TeX.

Параметры:

gcGraphicsContextBase: Графический контекст.
xfloat: Координата x текста в координатах отображения.
yfloat: Координата y базовой линии текста в координатах отображения.
sstr: Текстовая строка TeX.
propFontProperties: Свойства шрифта.
anglefloat: Угол поворота в градусах против часовой стрелки.
mtextText: Исходный текстовый объект для отображения.

draw_text(gc, x, y, s, prop, angle, ismath=False, mtext=None)[исходный код]

Рисует текстовый объект.

Параметры:

gcGraphicsContextBase: Графический контекст.
xfloat: Координата x текста в координатах отображения.
yfloat: Координата y базовой линии текста в координатах отображения.
sstr: Текстовая строка.
propFontProperties: Свойства шрифта.
anglefloat: Угол поворота в градусах против часовой стрелки.
ismathbool or "TeX": Если True, использовать анализатор mathtext.
mtextText: Исходный текстовый объект для отображения.

Примечания

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

RendererBase.draw_text также поддерживает передачу значения "TeX" параметру ismath для использования рендеринга TeX, однако это не является обязательным для бэкендов, выполняющих фактический рендеринг, и многие встроенные бэкенды эту возможность не поддерживают. Вместо этого рендеринг TeX обеспечивается методом draw_tex.

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

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

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

get_canvas_width_height()[исходный код]: Возвращает ширину и высоту холста в координатах отображения.

get_text_width_height_descent(s, prop, ismath)[исходный код]

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

Пробелы в начале и конце s учитываются в возвращаемой ширине.

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

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

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

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

points_to_pixels(points)[исходный код]

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

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

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

Параметры:

pointsfloat или объект, подобный массиву

Возвращает:

Пункты, преобразованные в пиксели

matplotlib.backends.backend_pgf.make_pdf_to_png_converter()[исходный код]: Возвращает функцию, которая преобразует файл PDF в файл PNG.