backend_pgf

matplotlib.backends.backend_pgf.FigureCanvas[source]

псевдоним matplotlib.backends.backend_pgf.FigureCanvasPgf

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

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

propertystr_cache[source]

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.

Параметры

filenamestr или путь

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

keep_emptybool, по умолчанию: True

Если установлено в False, пустые PDF-файлы будут автоматически удалены при закрытии.

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

Словарь информации (см. раздел 10.2.1 PDF-справочника 'Document Information Dictionary'), например: {'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: matplotlib.backend_bases.RendererBase

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

Атрибуты

figurematplotlib.figure.Figure

Рисунок Matplotlib для инициализации высоты, ширины и dpi.

fhподобный файлу

Дескриптор файла для вывода команд рисования.

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.

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

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 с плавающей точкой

Возвращает

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

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

Базируется на object

[Устарело]

Примечания

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

staticadd(tmpdir)[source]

[Устарело]

Примечания

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

staticcleanup_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]