Функция Matplotlib savefig()
Справочная документация 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 | Описание |
|---|---|---|
| fname | str, Path или file-like | Имя выходного файла или файловый объект. Расширение автоматически определяет формат, например, 'plot.png', 'plot.pdf', 'plot.svg' |
| dpi | float или 'figure' | Разрешение вывода (точек на дюйм). 'figure' использует собственное dpi объекта Figure. Обычные значения: 72 (экран), 150 (обычный), 300 (печать) |
| format | str | Формат вывода, например, 'png', 'pdf', 'svg', 'eps', 'jpg'. Если не указан, определяется по имени файла |
| bbox_inches | str или Bbox | Границы обрезки: 'tight' (плотная обрезка, удаляет лишнее пустое пространство), None (использует исходный размер Figure) |
| pad_inches | float | Отступ (в дюймах), когда bbox_inches='tight', по умолчанию 0.1 |
| facecolor | color или 'auto' | Цвет фона выходного изображения; 'auto' использует facecolor объекта Figure |
| edgecolor | color или 'auto' | Цвет границы выходного изображения |
| transparent | bool | Если True, фон делается прозрачным (только png/svg) |
| metadata | dict | Метаданные, записываемые в файл (поддерживается некоторыми форматами) |
Должно быть
plt.show()вызванный ранееsavefig(), потому что show() очищает Figure. Или используйтеfig.savefig()Укажите объект Figure.
Поддерживаемые форматы файлов
| Формат | Расширение | Особенности |
|---|---|---|
| PNG | .png | Растровое изображение, поддерживает прозрачность, используется чаще всего |
| Векторная графика, подходит для публикаций, может быть встроена в 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()
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()
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()
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)")
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значение параметра.
Другие расширения