Spec-Zone.ru › Matplotlib 3.6

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, необязательно

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

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

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

Print Stdout

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

Печать в стандартный поток
Rasterization for vector graphics

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

Растризация векторной графики
SVG Filter Line

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

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

SVG Фильтр Круговой диаграммы

SVG Фильтр Круговой диаграммы
SVG Histogram

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

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

SVG Подсказка

SVG Подсказка

© 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

Spec-Zone.ru

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