matplotlib.pyplot.savefig

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

Сохранение текущей фигуры.

Вызов:

savefig(fname, dpi=None, facecolor='w', edgecolor='w',
        orientation='portrait', papertype=None, format=None,
        transparent=False, bbox_inches=None, pad_inches=0.1,
        frameon=None, metadata=None)

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

Параметры:

Параметры:	`fnamestr or PathLike or file-like object` Путь, или объект Python-подобный файлу, или, возможно, объект, зависящий от бэкэнда, такой как `matplotlib.backends.backend_pdf.PdfPages`. Если format не задан, то формат вывода определяется из расширения fname, если таковое имеется, и из `rcParams["savefig.format"]` (по умолчанию: 'png') в противном случае. Если format задан, он определяет формат вывода. Следовательно, если fname не является путём или не имеет расширения, не забудьте указать format, чтобы убедиться, что используется правильный бэкэнд.
Другие параметры:	`dpi[ None \| scalar > 0 \| 'figure' ]` Разрешение в точках на дюйм. Если None, по умолчанию `rcParams["savefig.dpi"]` (по умолчанию: 'figure'). Если 'figure', используется значение dpi фигуры. `quality[ None \| 1 <= scalar <= 100 ]` Качество изображения в масштабе от 1 (худшее) до 95 (лучшее). Применимо только для форматов jpg или jpeg, в противном случае игнорируется. Если None, по умолчанию `rcParams["savefig.jpeg_quality"]` (по умолчанию: 95). Значения выше 95 следует избегать; 100 полностью отключает стадию квантования JPEG. `optimizebool` Если True, указывает, что кодировщик JPEG должен выполнить дополнительный проход по изображению для выбора оптимальных настроек кодировщика. Применимо только для форматов jpg или jpeg, в противном случае игнорируется. По умолчанию False. `progressivebool` Если True, указывает, что это изображение должно быть сохранено как прогрессивный файл JPEG. Применимо только для форматов jpg или jpeg, в противном случае игнорируется. По умолчанию False. `facecolorcolor or None, optional` Цвет лица фигуры; если None, по умолчанию `rcParams["savefig.facecolor"]` (по умолчанию: 'white'). `edgecolorcolor or None, optional` Цвет обводки фигуры; если None, по умолчанию `rcParams["savefig.edgecolor"]` (по умолчанию: 'white') `orientation{'landscape', 'portrait'}` В настоящее время поддерживается только бэкэндом postscript. `papertypestr` Один из 'letter', 'legal', 'executive', 'ledger', 'a0' по 'a10', 'b0' по 'b10'. Поддерживается только для вывода postscript. `formatstr` Формат файла, например, 'png', 'pdf', 'svg' и т. д. Поведение при отсутствии этого параметра описано в разделе fname. `transparentbool` Если True, все области осей будут прозрачными; область фигуры также будет прозрачной, если не указаны facecolor и/или edgecolor через kwargs. Это полезно, например, для отображения графика поверх цветного фона на веб-странице. Прозрачность этих областей будет восстановлена до исходных значений после выхода из этой функции. `bbox_inchesstr or Bbox, optional` Прямоугольник в дюймах. Сохраняется только указанная часть фигуры. Если 'tight', пытается определить ограниченный прямоугольник фигуры. Если None, используется savefig.bbox `pad_inchesscalar, optional` Количество отступов вокруг фигуры, когда bbox_inches равен 'tight'. Если None, используется savefig.pad_inches `bbox_extra_artistslist of Artist, optional` Список дополнительных элементов, которые будут учтены при вычислении ограниченного прямоугольника. `metadatadict, optional` Параметры ключевое слово/значение для хранения в метаданных изображения. Поддерживаемые ключи и значения по умолчанию зависят от формата изображения и бэкэнда: 'png' с бэкэндом Agg: См. параметр `metadata` `print_png`. 'pdf' с бэкэндом pdf: См. параметр `metadata` `PdfPages`. 'eps' и 'ps' с бэкэндом PS: Поддерживается только 'Creator'. `pil_kwargsdict, optional` Дополнительные параметры ключевое слово/значение, передаваемые в `PIL.Image.save` при сохранении фигуры. Применимо только для форматов, которые сохраняются с помощью Pillow, т. е. JPEG, TIFF и (если ключ задан не как None) PNG.

fnamestr or PathLike or file-like object

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

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

Следовательно, если fname не является путём или не имеет расширения, не забудьте указать format, чтобы убедиться, что используется правильный бэкэнд.

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

dpi[ None | scalar > 0 | 'figure' ]

Разрешение в точках на дюйм. Если None, по умолчанию rcParams["savefig.dpi"] (по умолчанию: 'figure'). Если 'figure', используется значение dpi фигуры.

quality[ None | 1 <= scalar <= 100 ]

Качество изображения в масштабе от 1 (худшее) до 95 (лучшее). Применимо только для форматов jpg или jpeg, в противном случае игнорируется. Если None, по умолчанию rcParams["savefig.jpeg_quality"] (по умолчанию: 95). Значения выше 95 следует избегать; 100 полностью отключает стадию квантования JPEG.

optimizebool

Если True, указывает, что кодировщик JPEG должен выполнить дополнительный проход по изображению для выбора оптимальных настроек кодировщика. Применимо только для форматов jpg или jpeg, в противном случае игнорируется. По умолчанию False.

progressivebool

Если True, указывает, что это изображение должно быть сохранено как прогрессивный файл JPEG. Применимо только для форматов jpg или jpeg, в противном случае игнорируется. По умолчанию False.

facecolorcolor or None, optional

Цвет лица фигуры; если None, по умолчанию rcParams["savefig.facecolor"] (по умолчанию: 'white').

edgecolorcolor or None, optional

Цвет обводки фигуры; если None, по умолчанию rcParams["savefig.edgecolor"] (по умолчанию: 'white')

orientation{'landscape', 'portrait'}

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

papertypestr

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

formatstr

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

transparentbool

Если True, все области осей будут прозрачными; область фигуры также будет прозрачной, если не указаны facecolor и/или edgecolor через kwargs. Это полезно, например, для отображения графика поверх цветного фона на веб-странице. Прозрачность этих областей будет восстановлена до исходных значений после выхода из этой функции.

bbox_inchesstr or Bbox, optional

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

pad_inchesscalar, optional

Количество отступов вокруг фигуры, когда bbox_inches равен 'tight'. Если None, используется savefig.pad_inches

bbox_extra_artistslist of Artist, optional

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

metadatadict, optional

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

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

pil_kwargsdict, optional

Дополнительные параметры ключевое слово/значение, передаваемые в PIL.Image.save при сохранении фигуры. Применимо только для форматов, которые сохраняются с помощью Pillow, т. е. JPEG, TIFF и (если ключ задан не как None) PNG.