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 или path-like или двоичный файл-like Путь, или объект Python-подобный файлу, или, возможно, объект, зависящий от бэкэнда, такой как `matplotlib.backends.backend_pdf.PdfPages`. Если format задан, он определяет формат вывода, и файл сохраняется как fname. Обратите внимание, что fname используется дословно, и не делается попытка согласовать расширение fname с format, и расширение не добавляется. Если format не задан, тогда формат определяется из расширения fname, если оно есть. Если format не задан и fname не имеет расширения, то файл сохраняется с `rcParams["savefig.format"]` (по умолчанию: `'png'`) и соответствующее расширение добавляется к fname.
Другие параметры:	dpifloat или 'figure', по умолчанию: `rcParams["savefig.dpi"]` (по умолчанию: `'figure'`) Разрешение в точках на дюйм. Если 'figure', используется значение dpi фигуры. qualityint, по умолчанию: `rcParams["savefig.jpeg_quality"]` (по умолчанию: `95`) Применимо только если format равен 'jpg' или 'jpeg', в противном случае игнорируется. Качество изображения в масштабе от 1 (худшее) до 95 (лучшее). Значения выше 95 следует избегать; 100 отключает части алгоритма сжатия JPEG и приводит к большим файлам с практически никаким увеличением качества изображения. Этот параметр устарел. optimizebool, по умолчанию: False Применимо только если format равен 'jpg' или 'jpeg', в противном случае игнорируется. Указывает, должен ли кодировщик выполнить дополнительный проход по изображению для выбора оптимальных параметров кодирования. Этот параметр устарел. progressivebool, по умолчанию: False Применимо только если format равен 'jpg' или 'jpeg', в противном случае игнорируется. Указывает, должно ли изображение храниться как файл JPEG с постепенной передачей. Этот параметр устарел. facecolorцвет или 'auto', по умолчанию: `rcParams["savefig.facecolor"]` (по умолчанию: `'auto'`) Цвет фона фигуры. Если 'auto', используется текущий цвет фона фигуры. edgecolorцвет или 'auto', по умолчанию: `rcParams["savefig.edgecolor"]` (по умолчанию: `'auto'`) Цвет обводки фигуры. Если 'auto', используется текущий цвет обводки фигуры. orientation{'landscape', 'portrait'} В настоящее время поддерживается только бэкэндом postscript. papertypestr Один из 'letter', 'legal', 'executive', 'ledger', 'a0' через 'a10', 'b0' через 'b10'. Поддерживается только для вывода postscript. formatstr Формат файла, например 'png', 'pdf', 'svg' и т.д. Поведение при отсутствии этого параметра описано в разделе fname. transparentbool Если True, все области Axes будут прозрачными; область фигуры также будет прозрачной, если facecolor и/или edgecolor не заданы через kwargs. Это полезно, например, для отображения графика поверх цветного фона на веб-странице. Прозрачность этих областей будет восстановлена до их исходных значений при выходе из этой функции. bbox_inchesstr или `Bbox`, по умолчанию: `rcParams["savefig.bbox"]` (по умолчанию: `None`) Область в дюймах: сохраняется только указанная часть фигуры. Если 'tight', пытается определить плотное поле фигуры. pad_inchesfloat, по умолчанию: `rcParams["savefig.pad_inches"]` (по умолчанию: `0.1`) Размер отступа вокруг фигуры, когда bbox_inches равен 'tight'. bbox_extra_artistsсписок `Artist`, необязательно Список дополнительных элементов, которые будут учитываться при вычислении плотной области. backendstr, необязательно Используйте бэкэнд по умолчанию для отображения файла, например, для отображения файла png с бэкэндом "cairo" вместо значения по умолчанию "agg" или файла pdf с бэкэндом "pgf" вместо значения по умолчанию "pdf". Обратите внимание, что бэкэнд по умолчанию обычно достаточен. См. Встроенные бэкэнды для списка допустимых бэкэндов для каждого формата файла. Пользовательские бэкэнды могут быть указаны как "module://...". metadatadict, необязательно Ключ/значение для хранения в метаданных изображения. Поддерживаемые ключи и значения по умолчанию зависят от формата изображения и бэкэнда: 'png' с бэкэндом Agg: См. параметр `metadata` у `print_png`. 'pdf' с бэкэндом pdf: См. параметр `metadata` у `PdfPages`. 'svg' с бэкэндом svg: См. параметр `metadata` у `print_svg`. 'eps' и 'ps' с бэкэндом PS: Поддерживается только 'Creator'. pil_kwargsdict, необязательно Дополнительные ключевые параметры, которые передаются в `PIL.Image.Image.save` при сохранении фигуры.

fnamestr или path-like или двоичный файл-like

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

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

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

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

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

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

qualityint, по умолчанию: rcParams["savefig.jpeg_quality"] (по умолчанию: 95)

Применимо только если format равен 'jpg' или 'jpeg', в противном случае игнорируется.

Качество изображения в масштабе от 1 (худшее) до 95 (лучшее). Значения выше 95 следует избегать; 100 отключает части алгоритма сжатия JPEG и приводит к большим файлам с практически никаким увеличением качества изображения.

Этот параметр устарел.

optimizebool, по умолчанию: False

Применимо только если format равен 'jpg' или 'jpeg', в противном случае игнорируется.

Указывает, должен ли кодировщик выполнить дополнительный проход по изображению для выбора оптимальных параметров кодирования.

Этот параметр устарел.

progressivebool, по умолчанию: False

Применимо только если format равен 'jpg' или 'jpeg', в противном случае игнорируется.

Указывает, должно ли изображение храниться как файл JPEG с постепенной передачей.

Этот параметр устарел.

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

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

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

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

orientation{'landscape', 'portrait'}

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

papertypestr

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

formatstr

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

transparentbool

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

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

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

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

Размер отступа вокруг фигуры, когда bbox_inches равен 'tight'.

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

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

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

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

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