Функция Matplotlib savefig()


Matplotlib 参考文档Справочная документация Matplotlib

savefig()Используется для сохранения текущего Figure в виде файла изображения; поддерживает PNG, PDF, SVG, EPS и другие форматы.

Это основной метод экспорта диаграмм Matplotlib в файлы, которые можно распространять и встраивать в документы.

Определение функции

Интерфейс pyplot

matplotlib.pyplot.savefig(fname, *, dpi='figure', format=None,
    metadata=None, bbox_inches=None, pad_inches=0.1, facecolor='auto',
    edgecolor='auto', backend=None, **kwargs)

Метод Figure

Figure.savefig(fname, *, dpi='figure', format=None, metadata=None,
    bbox_inches=None, pad_inches=0.1, facecolor='auto',
    edgecolor='auto', backend=None, **kwargs)

Описание параметра

ПараметрTypeОписание
fnamestr, Path или file-likeИмя выходного файла или файловый объект. Расширение автоматически определяет формат, например, 'plot.png', 'plot.pdf', 'plot.svg'
dpifloat или 'figure'Разрешение вывода (точек на дюйм). 'figure' использует собственное dpi объекта Figure. Обычные значения: 72 (экран), 150 (обычный), 300 (печать)
formatstrФормат вывода, например, 'png', 'pdf', 'svg', 'eps', 'jpg'. Если не указан, определяется по имени файла
bbox_inchesstr или BboxГраницы обрезки: 'tight' (плотная обрезка, удаляет лишнее пустое пространство), None (использует исходный размер Figure)
pad_inchesfloatОтступ (в дюймах), когда bbox_inches='tight', по умолчанию 0.1
facecolorcolor или 'auto'Цвет фона выходного изображения; 'auto' использует facecolor объекта Figure
edgecolorcolor или 'auto'Цвет границы выходного изображения
transparentboolЕсли True, фон делается прозрачным (только png/svg)
metadatadictМетаданные, записываемые в файл (поддерживается некоторыми форматами)

Должно бытьplt.show()вызванный ранееsavefig(), потому что show() очищает Figure. Или используйтеfig.savefig()Укажите объект Figure.

Поддерживаемые форматы файлов

ФорматРасширениеОсобенности
PNG.pngРастровое изображение, поддерживает прозрачность, используется чаще всего
PDF.pdfВекторная графика, подходит для публикаций, может быть встроена в LaTeX
SVG.svgВекторная графика, редактируется в браузерах/редакторах
EPS.epsВекторная графика, традиционный формат для публикации
JPEG.jpg / .jpegРастровое изображение, сжатие с потерями, небольшой размер файла, но не поддерживает прозрачность
TIFF.tiff / .tifРастровое изображение, без потерь, подходит для архивирования

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

Пример 1: Базовое сохранение

Пример

import matplotlib.pyplot as plt
import numpy as np

x = np.linspace(0, 10, 100)
fig, ax = plt.subplots(figsize=(6, 4))
ax.plot(x, np.sin(x), label='sin(x)')
ax.set_title('Save Figure Demo')
ax.legend()

# Сохранить как PNG
fig.savefig('example_plot.png')
print("пример: сохранено как example_plot.png")

# Сохранить как PDF (векторный)
fig.savefig('example_plot.pdf')
print("пример: сохранено как example_plot.pdf")

plt.show()

Пример 2: Вывод в высоком разрешении + плотная обрезка

Пример

import matplotlib.pyplot as plt
import numpy as np

fig, ax = plt.subplots(figsize=(8, 4))
x = np.linspace(0, 2*np.pi, 100)

ax.plot(x, np.sin(x), label='sin(x)')
ax.plot(x, np.cos(x), label='cos(x)')
ax.set_title('Вывод в высоком разрешении')
ax.set_xlabel('Угол (rad)')
ax.legend(loc='outside')  # Разместить легенду снаружи

# dpi=300: высокое качество (подходит для печати)
# bbox_inches='tight': автоматическая обрезка, чтобы легенда не выходила за границы
fig.savefig('example_hires.png', dpi=300, bbox_inches='tight')
print("пример: изображение с высоким разрешением сохранено")

plt.show()

Пример 3: Прозрачный фон + Различные форматы

Пример

import matplotlib.pyplot as plt
import numpy as np

fig, ax = plt.subplots(figsize=(6, 4))

# Установите тёмный фон, чтобы продемонстрировать эффект прозрачности
fig.patch.set_facecolor('#2c3e50')
ax.set_facecolor('#34495e')

ax.plot(np.random.randn(100).cumsum(),
        color='#1A6BBC', linewidth=2)
ax.set_title('Прозрачный фон',
             color='white', fontsize=14)
ax.tick_params(colors='white')

# Прозрачный фон PNG
fig.savefig('example_transparent.png',
            transparent=True,          # Прозрачный фон
            dpi=150, bbox_inches='tight')

# SVG также может быть прозрачным
fig.savefig('example_transparent.svg',
            transparent=True,
            bbox_inches='tight')
print("пример: прозрачные изображения сохранены")

plt.show()

Пример 4: Пакетное сохранение нескольких подграфиков

Пример

import matplotlib.pyplot as plt
import numpy as np

# Создание большой фигуры, содержащей несколько графиков
data = np.random.randn(4, 100)

for i in range(4):
    fig, ax = plt.subplots(figsize=(6, 4))
    ax.plot(data[i].cumsum(), color=f'C{i}', linewidth=2)
    ax.set_title(f'Ряд {i+1}')
    ax.set_xlabel('Шаг')
    ax.set_ylabel('Накопленная сумма')
    ax.grid(True, alpha=0.3)

    # Пакетное сохранение, имя файла содержит индекс
    fig.savefig(f'example_series_{i+1}.png',
                dpi=200, bbox_inches='tight')
    plt.close(fig)  # Закрыть, чтобы избежать отображения

print("пример: сохранено 4 графика (с series_1 по series_4)")

ЧАВО

Сохранённое изображение пустое?

Проверьте, вызывается ли savefig() после show(). show() может очистить Figure.

Решение: вызовите savefig() до show() или используйтеfig.savefig()Укажите объект Figure.

Текст/подписи на изображении обрезаны?

Используйтеbbox_inches='tight'автоматическая обрезка, чтобы все элементы находились в пределах изображения.

Если проблема сохраняется, можно увеличитьpad_inchesзначение параметра.


Matplotlib 参考文档Справочная документация Matplotlib

Другие расширения