matplotlib.pyplot.savefig
- matplotlib.pyplot.savefig(*args, **kwargs)[source]
-
Сохранить текущую фигуру.
Вызов функции:
savefig(fname, *, 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.Если задан формат, он определяет формат выходных данных, и файл сохраняется как fname. Обратите внимание, что fname используется дословно, и не предпринимается попытка сделать расширение, если оно есть, fname совпадающим с форматом, и не добавляется расширение.
Если формат не задан, то формат определяется по расширению fname, если оно есть. Если формат не задан и fname не имеет расширения, то файл сохраняется с
rcParams["savefig.format"](по умолчанию:'png') и соответствующее расширение добавляется к fname.
- Другие параметры:
-
-
dpifloat или 'figure', по умолчанию:
rcParams["savefig.dpi"](по умолчанию:'figure') -
Разрешение в точках на дюйм. Если 'figure', используется значение dpi фигуры.
- форматстрока
-
Формат файла, например, 'png', 'pdf', 'svg' и т.д. Поведение при отсутствии этого параметра описано в разделе fname.
- metadataсловарь, необязательно
-
Ключевые пары для хранения в метаданных изображения. Поддерживаемые ключи и значения по умолчанию зависят от формата изображения и бэкэнда:
-
bbox_inchesстрока или
Bbox, по умолчанию:rcParams["savefig.bbox"](по умолчанию:None) -
Окружающая рамка в дюймах: сохраняется только заданная часть фигуры. Если 'tight', попробуйте определить строгую рамку фигуры.
-
pad_inchesчисло с плавающей точкой, по умолчанию:
rcParams["savefig.pad_inches"](по умолчанию:0.1) -
Количество отступа вокруг фигуры, когда bbox_inches равен 'tight'.
-
facecolorцвет или 'auto', по умолчанию:
rcParams["savefig.facecolor"](по умолчанию:'auto') -
Цвет заливки фигуры. Если 'auto', используется текущий цвет заливки фигуры.
-
edgecolorцвет или 'auto', по умолчанию:
rcParams["savefig.edgecolor"](по умолчанию:'auto') -
Цвет контура фигуры. Если 'auto', используется текущий цвет контура фигуры.
- backendстрока, необязательно
-
Используйте бэкэнд по умолчанию для рендеринга файла, например, для рендеринга файла png с бэкэндом "cairo" вместо стандартного "agg", или файла pdf с бэкэндом "pgf" вместо стандартного "pdf". Обратите внимание, что стандартный бэкэнд обычно достаточен. См. Встроенные бэкэнды для получения списка допустимых бэкэндов для каждого формата файла. Пользовательские бэкэнды могут быть указаны как "module://...".
- orientation{'landscape', 'portrait'}
-
В настоящее время поддерживается только бэкэндом postscript.
- papertypeстрока
-
Один из 'letter', 'legal', 'executive', 'ledger', 'a0' до 'a10', 'b0' до 'b10'. Поддерживается только для вывода в формате postscript.
- transparentлогическое значение
-
Если True, все области Axes будут прозрачными; область Figure также будет прозрачной, если не заданы facecolor и/или edgecolor через kwargs.
Если False не оказывает никакого влияния и цвет областей Axes и Figure остаются без изменений (если область Figure не задана через ключевые слова facecolor и/или edgecolor, в этом случае используются эти цвета).
Прозрачность этих областей будет восстановлена до их исходных значений при выходе из этой функции.
Это полезно, например, для отображения графика поверх цветного фона на веб-странице.
-
bbox_extra_artistsсписок
Artist, необязательно -
Список дополнительных объектов, которые будут учитываться при расчете строгих рамок.
- pil_kwargsсловарь, необязательно
-
Дополнительные ключевые аргументы, передаваемые
PIL.Image.Image.saveпри сохранении фигуры.
-
dpifloat или 'figure', по умолчанию:
Примеры использования matplotlib.pyplot.savefig
© 2012–2023 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/3.7.5/api/_as_gen/matplotlib.pyplot.savefig.html