Spec-Zone.ru › Matplotlib 3.8

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: см. параметр metadata print_png.
  • 'pdf' с бэкэндом pdf: см. параметр metadata PdfPages.
  • 'svg' с бэкэндом svg: см. параметр metadata print_svg.
  • 'eps' и 'ps' с бэкэндом PS: поддерживается только 'Creator'.

Не поддерживается для 'pgf', 'raw' и 'rgba', так как эти форматы не поддерживают встраивание метаданных. В настоящее время не поддерживает 'jpg', 'tiff' или 'webp', но в будущем может включать встраивание метаданных EXIF.

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 при сохранении фигуры.

Примеры использования matplotlib.pyplot.savefig

Печать в стандартный вывод

Печать в стандартный вывод

Растрирование векторной графики

Растрирование векторной графики

SVG Фильтр Линии

SVG Фильтр Линии

SVG фильтр круговой диаграммы

SVG фильтр круговой диаграммы

Демонстрация CanvasAgg

Демонстрация CanvasAgg

SVG Гистограмма

SVG Гистограмма

SVG Подсказка

SVG Подсказка

© 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API