matplotlib.pyplot.savefig

matplotlib.pyplot.savefig(*args, **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
       )

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

Параметры:

fnamestr or path-like or binary file-like

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

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

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

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

transparentbool, default: rcParams["savefig.transparent"] (default: False)

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

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

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

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

dpifloat or 'figure', default: rcParams["savefig.dpi"] (default: 'figure')

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

formatstr

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

metadatadict, optional

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

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

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

bbox_inchesstr or Bbox, default: rcParams["savefig.bbox"] (default: None)

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

pad_inchesfloat or 'layout', default: rcParams["savefig.pad_inches"] (default: 0.1)

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

facecolorcolor or 'auto', default: rcParams["savefig.facecolor"] (default: 'auto')

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

edgecolorcolor or 'auto', default: rcParams["savefig.edgecolor"] (default: 'auto')

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

backendstr, optional

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

orientation{'landscape', 'portrait'}