matplotlib.pyplot.savefig
- matplotlib.pyplot.savefig(*args, **kwargs)[source]
Сохранить текущую фигуру.
Вызов:
savefig(fname, *args, **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 также будет прозрачной, если не указаны facecolor и/или edgecolor через kwargs.
Если False, не оказывает никакого влияния и цвет областей Axes и Figure не меняются (если область Figure указана через ключевые аргументы facecolor и/или edgecolor, в этом случае используются эти цвета).
Прозрачность этих областей будет восстановлена до первоначальных значений по выходе из этой функции.
Это полезно, например, для отображения графика поверх цветного фона на веб-странице.
- dpifloat или 'figure', по умолчанию:
rcParams["savefig.dpi"](по умолчанию:'figure') Разрешение в точках на дюйм. Если 'figure', используется значение dpi фигуры.
- formatстрока
Формат файла, например, 'png', 'pdf', 'svg' и т. д. Поведение при отсутствии этого параметра описано в разделе fname.
- metadataсловарь, необязательно
Пара пары ключ/значение для хранения в метаданных изображения. Поддерживаемые ключи и значения по умолчанию зависят от формата изображения и бэкэнда:
- 'png' с бэкэндом Agg: см. параметр
metadataprint_png. - 'pdf' с бэкэндом pdf: см. параметр
metadataPdfPages. - 'svg' с бэкэндом svg: см. параметр
metadataprint_svg. - 'eps' и 'ps' с бэкэндом PS: поддерживается только 'Creator'.
Не поддерживается для 'pgf', 'raw' и 'rgba', так как эти форматы не поддерживают встраивание метаданных. В настоящее время не поддерживает 'jpg', 'tiff' или 'webp', но в будущем может включать встраивание метаданных EXIF.
- 'png' с бэкэндом Agg: см. параметр
- bbox_inchesстрока или
Bbox, по умолчанию:rcParams["savefig.bbox"](по умолчанию:None) Прямоугольник обрезки в дюймах: сохраняется только указанная часть фигуры. Если 'tight', пытается определить плотное прямоугольник обрезки фигуры.
- pad_inchesfloat или 'layout', по умолчанию:
rcParams["savefig.pad_inches"](по умолчанию:0.1) Количество отступа в дюймах вокруг фигуры, когда bbox_inches равно 'tight'. Если 'layout', используется отступ из движка ограничений или сжатия макета; игнорируется, если один из этих движков не используется.
- 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.
- bbox_extra_artistsсписок
Artist, необязательно Список дополнительных объектов, которые будут учитываться при вычислении плотного прямоугольника обрезки.
- pil_kwargsсловарь, необязательно
Дополнительные ключевые аргументы, передаваемые в
PIL.Image.Image.saveпри сохранении фигуры.
- transparentbool, по умолчанию:
Примеры использования matplotlib.pyplot.savefig
© 2012–2023 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/3.8.4/api/_as_gen/matplotlib.pyplot.savefig.html