matplotlib.figure.Figure.savefig

Figure.savefig(fname, *, transparent=None, **kwargs)[source]

Сохранение текущей фигуры в виде изображения или векторной графики в файл.

Вызов:

savefig(fname, *, transparent=None, dpi='figure', format=None,
        metadata=None, bbox_inches=None, pad_inches=0.1,
        facecolor='auto', edgecolor='auto', backend=None,
        **kwargs
       )

Доступные форматы выходных данных зависят от используемого бэкенда.

Параметры:

fnameстрока или путь или двоичный файл-подобный объект

Путь, или объект Python-подобный файлу, или, возможно, объект, зависящий от бэкенда, например matplotlib.backends.backend_pdf.PdfPages.

Если format задан, он определяет формат выходных данных, и файл сохраняется как fname. Обратите внимание, что fname используется дословно, и не делается попытка сделать расширение, если таковое имеется, fname соответствующим format, и расширение не добавляется.

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

Другие параметры:

transparentbool, по умолчанию: rcParams["savefig.transparent"] (по умолчанию: False)

Если True, все области Axes будут прозрачными; область Figure также будет прозрачной, если не указаны facecolor и/или edgecolor через kwargs.

Если False, это не имеет эффекта, и цвет областей Axes и Figure не изменяются (если область Figure не указана через ключевые аргументы facecolor и/или edgecolor, в этом случае используются эти цвета).

Прозрачность этих областей будет восстановлена до исходных значений по выходу из этой функции.

Это полезно, например, для отображения графика поверх цветного фона на веб-странице.

dpifloat или 'figure', по умолчанию: rcParams["savefig.dpi"] (по умолчанию: 'figure')

Разрешение в точках на дюйм. Если 'figure', используется значение dpi фигуры.

formatстрока

Формат файла, например, 'png', 'pdf', 'svg' и т.д. Поведение при отсутствии этого параметра описано в документации к fname.

metadataсловарь, необязательно

Ключевые пары для хранения в метаданных изображения. Поддерживаемые ключи и значения по умолчанию зависят от формата изображения и бэкенда:

'png' с бэкендом Agg: см. параметр metadata print_png.
'pdf' с бэкендом pdf: см. параметр metadata PdfPages.
'svg' с бэкендом svg: см. параметр metadata print_svg.
'eps' и 'ps' с бэкендом PS: поддерживается только 'Creator'.

Не поддерживается для 'pgf', 'raw' и 'rgba', так как эти форматы не поддерживают метаданные. В настоящее время не поддерживается для 'jpg', 'tiff' или 'webp', но в будущем может быть добавлена поддержка встраивания EXIF метаданных.

bbox_inchesстрока или Bbox, по умолчанию: rcParams["savefig.bbox"] (по умолчанию: None)

Прямоугольник обрезки в дюймах: сохраняется только указанная часть фигуры. Если 'tight', попытаться определить максимально возможный прямоугольник обрезки фигуры.

pad_inchesчисло или 'layout', по умолчанию: rcParams["savefig.pad_inches"] (по умолчанию: 0.1)

Количество отступа в дюймах вокруг фигуры, когда bbox_inches равен 'tight'. Если 'layout', используется отступ из конструированного или сжатого механизма макета; игнорируется, если один из этих механизмов не используется.

facecolorцвет или 'auto', по умолчанию: rcParams["savefig.facecolor"] (по умолчанию: 'auto')

Цвет заливки фигуры. Если 'auto', используется текущий цвет заливки фигуры.

edgecolorцвет или 'auto', по умолчанию: rcParams["savefig.edgecolor"] (по умолчанию: 'auto')

Цвет обводки фигуры. Если 'auto', используется текущий цвет обводки фигуры.

backendстрока, необязательно

Используйте нестандартный бэкенд для отображения файла, например, для отображения файла png с бэкендом "cairo" вместо стандартного "agg", или файл pdf с бэкендом "pgf" вместо стандартного "pdf". Обратите внимание, что стандартный бэкенд обычно достаточен. См. Встроенные бэкенды для списка допустимых бэкендов для каждого формата файла. Пользовательские бэкенды могут быть указаны как "module://...".

orientation{'landscape', 'portrait'}

В настоящее время поддерживается только бэкендом postscript.

papertypeстрока

Один из 'letter', 'legal', 'executive', 'ledger', 'a0' до 'a10', 'b0' до 'b10'. Поддерживается только для постскриптового вывода.

bbox_extra_artistsсписок Artist, необязательно

Список дополнительных объектов, которые будут учтены при вычислении прямоугольника обрезки.

pil_kwargsсловарь, необязательно

Дополнительные ключевые аргументы, которые передаются в PIL.Image.Image.save при сохранении фигуры.

Примеры использования `matplotlib.figure.Figure.savefig`

Простой график

Преобразование текста в изображения

Эллипс с единицами

Демонстрация CanvasAgg

Шрифты PGF

PGF texsystem

Руководство по принудительной компоновке

matplotlib.figure.Figure.savefig

Примеры использования matplotlib.figure.Figure.savefig

Примеры использования `matplotlib.figure.Figure.savefig`