matplotlib.backends.backend_pdf

Модуль matplotlib для работы с форматом PDF. Автор: Jouni K Seppänen <jks@iki.fi>

matplotlib.backends.backend_pdf.FigureCanvas

Псевдоним для matplotlib.backends.backend_pdf.FigureCanvasPdf

class matplotlib.backends.backend_pdf.FigureCanvasPdf(figure) [source]

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

Поверхность холста для отрисовки фигуры. Вызывает методы draw и print fig, создаёт рендереры и т.д...

Атрибуты:	figure : matplotlib.figure.Figure Экземпляр Figure высокого уровня

draw() [source]

Отрисовка Figure.

filetypes = {'pdf': 'Portable Document Format'}

fixed_dpi = 72

get_default_filetype() [source]

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

print_pdf(filename, **kwargs) [source]

matplotlib.backends.backend_pdf.FigureManager

Псевдоним для matplotlib.backends.backend_pdf.FigureManagerPdf

class matplotlib.backends.backend_pdf.FigureManagerPdf(canvas, num) [source]

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

class matplotlib.backends.backend_pdf.GraphicsContextPdf(file) [source]

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

alpha_cmd(alpha, forced, effective_alphas) [source]

capstyle_cmd(style) [source]

capstyles = {'butt': 0, 'projecting': 2, 'round': 1}

clip_cmd(cliprect, clippath) [source]

Установка прямоугольника обрезки. Вызывает self.pop() и self.push().

commands = ((('_cliprect', '_clippath'), <function GraphicsContextPdf.clip_cmd>), (('_alpha', '_forced_alpha', '_effective_alphas'), <function GraphicsContextPdf.alpha_cmd>), (('_capstyle',), <function GraphicsContextPdf.capstyle_cmd>), (('_fillcolor',), <function GraphicsContextPdf.fillcolor_cmd>), (('_joinstyle',), <function GraphicsContextPdf.joinstyle_cmd>), (('_linewidth',), <function GraphicsContextPdf.linewidth_cmd>), (('_dashes',), <function GraphicsContextPdf.dash_cmd>), (('_rgb',), <function GraphicsContextPdf.rgb_cmd>), (('_hatch', '_hatch_color'), <function GraphicsContextPdf.hatch_cmd>))

copy_properties(other) [source]

Копирование свойств другого объекта в себя.

dash_cmd(dashes) [source]

delta(other) [source]

Копирует свойства другого объекта в себя и возвращает PDF-команды, необходимые для преобразования себя в другой объект.

fill(*args) [source]

Предикат: нужно ли заполнять путь?

Необязательный аргумент может быть использован для указания альтернативного _fillcolor, как это необходимо для RendererPdf.draw_markers.

fillcolor_cmd(rgb) [source]

finalize() [source]

Убедитесь, что каждый поставленный графический слой извлечён.

hatch_cmd(hatch, hatch_color) [source]

joinstyle_cmd(style) [source]

joinstyles = {'bevel': 2, 'miter': 0, 'round': 1}

linewidth_cmd(width) [source]

paint() [source]

Возвращает соответствующий PDF-оператор для рисования, заполнения или обоих.

pop() [source]

push() [source]

rgb_cmd(rgb) [source]

stroke() [source]

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

class matplotlib.backends.backend_pdf.Name(name) [source]

Bases: object

Объект имени в формате PDF.

static hexify(match) [source]

name

pdfRepr() [source]

class matplotlib.backends.backend_pdf.Operator(op) [source]

Bases: object

Объект оператора PDF.

op

pdfRepr() [source]

class matplotlib.backends.backend_pdf.PdfFile(filename, metadata=None) [source]

Bases: object

Объект файла PDF.

addGouraudTriangles(points, colors) [source]

alphaState(alpha) [source]

Возвращает имя ExtGState, устанавливающее альфа-значение до заданного.

beginStream(id, len, extra=None, png=None) [source]

close() [source]

Очистить все буферы и освободить все ресурсы.

createType1Descriptor(t1font, fontfile) [source]

dviFontName(dvifont) [source]

Принимая на вход объект шрифта dvi, возвращает имя, подходящее для Op.selectfont. Регистрирует информацию о шрифте в self.dviFontInfo, если она ещё не зарегистрирована.

embedTTF(filename, characters) [source]

Встраивает шрифт TTF из указанного файла в документ.

endStream() [source]

finalize() [source]

Записывает различные отложенные объекты и заключительную часть PDF.

fontName(fontprop) [source]

Выбирает шрифт на основе fontprop и возвращает имя, подходящее для Op.selectfont. Если fontprop является строкой, она интерпретируется как имя файла шрифта.

hatchPattern(hatch_style) [source]

imageObject(image) [source]

Возвращает имя изображения XObject, представляющего данное изображение.

markerObject(path, trans, fill, stroke, lw, joinstyle, capstyle) [source]

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

newPage(width, height) [source]

newTextnote(text, positionRect=[-100, -100, 0, 0]) [source]

output(*data) [source]

pathCollectionObject(gc, path, trans, padding, filled, stroked) [source]

static pathOperations(path, transform, clip=None, simplify=None, sketch=None) [source]

recordXref(id) [source]

reserveObject(name='') [source]

Зарезервировать ID для косвенного объекта. Имя используется для отладки, если мы забудем напечатать объект с помощью writeObject.

texFontMap

write(data) [source]

writeFonts() [source]

writeGouraudTriangles() [source]

writeHatches() [source]

writeImages() [source]

writeInfoDict() [source]

Записать словарь info, проверив его корректность.

writeMarkers() [source]

writeObject(object, contents) [source]

writePath(path, transform, clip=False, sketch=None) [source]

writePathCollectionTemplates() [source]

writeTrailer() [source]

Записать трайлер PDF.

writeXref() [source]

Записать таблицу xref.

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

Основы: object

Многостраничный PDF-файл.

Примечания

На самом деле PdfPages является тонким оболочкой вокруг PdfFile, чтобы избежать путаницы при использовании savefig() и забытии аргумента формата.

Примеры

>>> 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', 'Creator', 'Producer', 'CreationDate', 'ModDate', и 'Trapped'. Значения предопределены для 'Creator', 'Producer' и 'CreationDate'. Их можно удалить, установив их значение в None.

attach_note(text, positionRect=[-100, -100, 0, 0]) [source]

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

close() [source]

Завершение работы с объектом, делая базовый файл полным PDF-файлом.

get_pagecount() [source]

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

infodict() [source]

Возвращает изменяемый словарь информации (см. раздел 10.2.1 справочника по PDF «Словарь информации документа»).

keep_empty

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

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

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

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

class matplotlib.backends.backend_pdf.Reference(id) [source]

Основы: object

Объект ссылки PDF. Используйте PdfFile.reserveObject(), чтобы создать ссылки.

pdfRepr() [source]

write(contents, file) [source]

class matplotlib.backends.backend_pdf.RendererPdf(file, image_dpi, height, width) [source]

Основы: matplotlib.backend_bases.RendererBase

afm_font_cache = {}

check_gc(gc, fillcolor=None) [source]

draw_gouraud_triangle(gc, points, colors, trans) [source]

Отрисовка треугольника с заливкой по методу Гуро.

Параметры:	points : array_like, shape=(3, 2) Массив точек (x, y) для треугольника. colors : array_like, shape=(3, 4) RGBA цвета для каждой точки треугольника. transform : matplotlib.transforms.Transform Аффинное преобразование, применяемое к точкам.

draw_gouraud_triangles(gc, points, colors, trans) [source]

Отрисовка серии треугольников с заливкой по методу Гуро.

Параметры:	points : array_like, shape=(N, 3, 2) Массив из N точек (x, y) для треугольников. colors : array_like, shape=(N, 3, 4) Массив из N RGBA цветов для каждой точки треугольников. transform : matplotlib.transforms.Transform Аффинное преобразование, применяемое к точкам.

draw_image(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(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_mathtext(gc, x, y, s, prop, angle) [source]

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

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

draw_path_collection(gc, master_transform, paths, all_transforms, offsets, offsetTrans, facecolors, edgecolors, linewidths, linestyles, antialiaseds, urls, offset_position) [source]

Отрисовка набора путей, выбирая свойства отрисовки из списков facecolors, edgecolors, linewidths, linestyles и antialiaseds. offsets — список смещений, применяемых к каждому из путей. Смещения в offsets сначала преобразуются с помощью offsetTrans перед применением. offset_position может быть либо "экран", либо "данные", в зависимости от пространства, в котором находятся смещения.

Это предоставляет реализацию по умолчанию для draw_path_collection(), которая делает несколько вызовов draw_path(). Некоторые бэкэнды могут переопределить этот метод, чтобы отобразить данные каждой группы путей только один раз, а затем ссылаться на этот путь несколько раз с разными смещениями, цветами, стилями и т. д. Методы-генераторы _iter_collection_raw_paths() и _iter_collection() предназначены для помощи (и стандартизации) реализации через бэкэнды. Настоятельно рекомендуется использовать эти генераторы, чтобы изменения в поведении draw_path_collection() можно было внести глобально.

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]

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

Параметры:	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, и тогда вместе с текстом будет нарисован и сам прямоугольник.

encode_string(s, fonttype) [source]

finalize() [source]

flipy() [source]

Возвращает true, если меньшие значения y находятся вверху для рендерера. Используется только для рисования текста (matplotlib.text) и изображений (matplotlib.image).

get_canvas_width_height() [source]

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

get_image_magnification() [source]

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

get_text_width_height_descent(s, prop, ismath) [source]

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

merge_used_characters(other) [source]

new_gc() [source]

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

option_image_nocomposite() [source]

Возвращает, нужно ли создавать составное изображение из нескольких изображений на наборе осей.

option_scale_image() [source]

Бэкенд pdf поддерживает произвольное масштабирование изображений.

track_characters(font, s) [source]

Отслеживает необходимые символы из каждого шрифта.

class matplotlib.backends.backend_pdf.Stream(id, len, file, extra=None, png=None) [source]

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

Объект потока PDF.

У него нет метода pdfRepr. Вместо этого вызовите begin(), затем выведите содержимое потока, вызвав write(), и, наконец, вызовите end().

id: идентификатор объекта потока; len: неиспользуемый объект Reference для длины потока или None (для использования буфера памяти); file: PdfFile; extra: словарь дополнительных пар ключ-значение для включения в заголовок потока; png: если данные уже сжаты с помощью png, параметры декодирования

compressobj

end() [source]

Завершить поток.

extra

file

id

len

pdfFile

pos

write(data) [source]

Записать данные в поток.

class matplotlib.backends.backend_pdf.Verbatim(x) [source]

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

Хранит содержимое verbatim команд PDF для последующего включения в поток.

pdfRepr() [source]

matplotlib.backends.backend_pdf.fill(strings, linelen=75) [source]

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

matplotlib.backends.backend_pdf.pdfRepr(obj) [source]

Преобразует объекты Python в синтаксис PDF.