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)

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

Параметры:

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

fname : str or PathLike or file-like object

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

Если формат не задан, тогда формат вывода определяется из расширения fname, если оно есть, и из rcParams["savefig.format"] в противном случае. Если формат задан, он определяет формат вывода.

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

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

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

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

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

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

optimize : bool

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

progressive : bool

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

facecolor : color spec or None, optional

Цвет фона рисунка; если None, по умолчанию rcParams["savefig.facecolor"].

edgecolor : color spec or None, optional

Цвет обводки рисунка; если None, по умолчанию rcParams["savefig.edgecolor"].

orientation : {'landscape', 'portrait'}

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

papertype : str

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

format : str

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

transparent : bool

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

bbox_inches : str or Bbox, optional

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

pad_inches : scalar, optional

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

bbox_extra_artists : list of Artist, optional

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

metadata : dict, optional

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

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

pil_kwargs : dict, optional

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