matplotlib.pyplot.savefig

matplotlib.pyplot.savefig(*args, **kwargs)[source]

Сохранение текущего рисунка.

Вызов сигнатуры:

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

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

Параметры

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

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

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

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

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

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

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

форматstr

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

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

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

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

bbox_inchesstr или Bbox, по умолчанию: rcParams["savefig.bbox"] (по умолчанию: None)

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

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

Количество отступа вокруг рисунка, когда bbox_inches равен 'tight'.

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

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

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

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

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

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

orientation{'landscape', 'portrait'}

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

papertypestr

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

transparentbool

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

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

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

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

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

Список дополнительных художников, которые будут учитываться при расчете плотной области.

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

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

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