matplotlib.figure.Figure.savefig

Figure.savefig(fname, *, transparent=None, **kwargs)[исходный код]

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

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

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 также будет прозрачным, если только через kwargs не заданы facecolor и/или edgecolor.

Если 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_inchesстрока или Bbox, по умолчанию: rcParams["savefig.bbox"] (по умолчанию: None)

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

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

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

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.

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

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

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

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

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

Линейный график

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

Эллипс с единицами измерения

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

Руководство по ограниченной компоновке

matplotlib.figure.Figure.savefig

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

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