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
       )

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

Параметры:

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

Путь, или объект 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 фигуры.

formatstr

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

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

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

'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_inchesstr или Bbox, по умолчанию: rcParams["savefig.bbox"] (по умолчанию: None)

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

pad_inchesfloat или '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', используется текущий цвет обводки фигуры.

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

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

orientation{'landscape', 'portrait'}