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 фигуры.
- форматstr
-
Формат файла, например, 'png', 'pdf', 'svg', ... Поведение, когда это не задано, описано в fname.
- metadatadict, необязательно
-
Ключевые/значения пары для хранения в метаданных изображения. Поддерживаемые ключи и значения по умолчанию зависят от формата изображения и бэкэнда:
-
bbox_inchesstr или
Bbox, по умолчанию:rcParams["savefig.bbox"](по умолчанию:None) -
Прямоугольник в дюймах: сохраняется только заданная часть фигуры. Если 'tight', попытаться определить прямоугольник 'tight' фигуры.
-
pad_inchesfloat, по умолчанию:
rcParams["savefig.pad_inches"](по умолчанию:0.1) -
Количество отступа вокруг фигуры, когда bbox_inches равен 'tight'.
-
facecolorцвет или 'auto', по умолчанию:
rcParams["savefig.facecolor"](по умолчанию:'auto') -
Цвет заливки фигуры. Если 'auto', используется текущий цвет заливки фигуры.
-
edgecolorцвет или 'auto', по умолчанию:
rcParams["savefig.edgecolor"](по умолчанию:'auto') -
Цвет обводки фигуры. Если 'auto', используется текущий цвет обводки фигуры.
- backendstr, необязательно
-
Использовать бэкэнд по умолчанию для рендеринга файла, например, для рендеринга файла png с бэкэндом "cairo" вместо стандартного "agg", или файла pdf с бэкэндом "pgf" вместо стандартного "pdf". Обратите внимание, что, как правило, достаточно стандартного бэкэнда. Смотрите Встроенные бэкэнды для списка допустимых бэкэндов для каждого формата файла. Пользовательские бэкэнды могут быть указаны как "module://...".
- orientation{'landscape', 'portrait'}
-
В настоящее время поддерживается только бэкэндом postscript.
- papertypestr
-
Одно из 'letter', 'legal', 'executive', 'ledger', 'a0' через 'a10', 'b0' через 'b10'. Поддерживается только для вывода postscript.
- transparentbool
-
Если True, области Axes будут прозрачными; область Figure также будет прозрачной, если не заданы facecolor и/или edgecolor в kwargs.
Если False, не имеет эффекта, и цвет областей Axes и Figure не изменяется (если область Figure задана с помощью аргументов ключевых слов facecolor и/или edgecolor, в этом случае используются эти цвета).
Прозрачность этих областей будет восстановлена до исходных значений по выходу из этой функции.
Это полезно, например, для отображения графика поверх цветного фона на веб-странице.
-
bbox_extra_artistsсписок из
Artist, необязательно -
Список дополнительных элементов, которые будут рассмотрены при вычислении прямоугольника.
- pil_kwargsdict, необязательно
-
Дополнительные аргументы ключевых слов, которые передаются
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.6.0/api/_as_gen/matplotlib.pyplot.savefig.html