backend_pgf

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

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

Базы: FigureCanvasBase

Отображение 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.

propertylatex_header[source]

propertystr_cache[source]

propertytexcommand[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-справочника «Словарь информации о документе»), например: {'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]

Основы: RendererBase

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

Атрибуты:

figurematplotlib.figure.Figure: Объект Matplotlib figure для инициализации высоты, ширины и 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_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.

Векторные бэкэнды обычно должны возвращать True (чтобы растровый растризатор на 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

Parameters:

pointsfloat или массив-подобный объект: вещественное число или массив NumPy с вещественными числами

Returns:

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

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: