Función Matplotlib savefig()
Documentación de referencia de Matplotlib
savefig()Se utiliza para guardar la Figura actual como archivo de imagen, compatible con múltiples formatos como PNG, PDF, SVG, EPS.
Es el método central para exportar gráficos de Matplotlib a archivos que se pueden compartir e incrustar en documentos.
Definición de la función
Interfaz 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)
Método Figure
Figure.savefig(fname, *, dpi='figure', format=None, metadata=None,
bbox_inches=None, pad_inches=0.1, facecolor='auto',
edgecolor='auto', backend=None, **kwargs)
Descripción de parámetros
| Parámetro | Tipo | Descripción |
|---|---|---|
| fname | str, Path o file-like | Nombre de archivo de salida u objeto de archivo. La extensión determina automáticamente el formato, como 'plot.png', 'plot.pdf', 'plot.svg' |
| dpi | float o 'figure' | Resolución de salida (puntos por pulgada). 'figure' usa el dpi de la propia Figure. Común: 72 (pantalla), 150 (general), 300 (impresión) |
| format | str | Formato de salida, como 'png', 'pdf', 'svg', 'eps', 'jpg'. Si no se especifica, se deduce del nombre del archivo |
| bbox_inches | str o Bbox | Límites de recorte: 'tight' (recorte ajustado, elimina espacios en blanco adicionales), None (usa el tamaño original de la Figure) |
| pad_inches | float | Relleno interior (en pulgadas) cuando bbox_inches='tight', por defecto 0.1 |
| facecolor | color o 'auto' | Color de fondo de la imagen de salida; 'auto' usa el facecolor de la Figure |
| edgecolor | color o 'auto' | Color del borde de la imagen de salida |
| transparent | bool | Si es True, el fondo se establece como transparente (solo png/svg) |
| metadata | dict | Metadatos que se escriben en el archivo (soportados por algunos formatos) |
Debe
plt.show()llamarse antessavefig(), porque show() vacía la Figure. O usefig.savefig()para especificar un objeto Figure.
Formatos de archivo compatibles
| Formato | Extensión | Características |
|---|---|---|
| PNG | .png | Mapa de bits, admite transparencia, el más común |
| Gráfico vectorial, adecuado para publicaciones, se puede incrustar en LaTeX | ||
| SVG | .svg | Gráfico vectorial, editable en navegadores/editores |
| EPS | .eps | Gráfico vectorial, formato tradicional de publicación |
| JPEG | .jpg / .jpeg | Mapa de bits, compresión con pérdida, archivo pequeño pero no admite transparencia |
| TIFF | .tiff / .tif | Mapa de bits, sin pérdida, adecuado para archivo |
Ejemplos de uso
Ejemplo 1: Guardado básico
Ejemplo
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()
# Guardar como PNG
fig.savefig('ejemplo_plot.png')
print("ejemplo: saved as ejemplo_plot.png")
# Guardar como PDF (vectorial)
fig.savefig('ejemplo_plot.pdf')
print("ejemplo: saved as ejemplo_plot.pdf")
plt.show()
Ejemplo 2: Salida de alta resolución + recorte ajustado
Ejemplo
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('High Resolution Output')
ax.set_xlabel('Angle (rad)')
ax.legend(loc='outside') # Colocar la leyenda en el exterior
# dpi=300: calidad de alta definición (adecuado para impresión)
# bbox_inches='tight': recorte automático, asegura que la leyenda no se salga
fig.savefig('ejemplo_hires.png', dpi=300, bbox_inches='tight')
print("ejemplo: high-res image saved")
plt.show()
Ejemplo 3: Fondo transparente + diferentes formatos
Ejemplo
import numpy as np
fig, ax = plt.subplots(figsize=(6, 4))
# Establecer un fondo oscuro para mostrar el efecto de transparencia
fig.patch.set_facecolor('#2c3e50')
ax.set_facecolor('#34495e')
ax.plot(np.random.randn(100).cumsum(),
color='#1A6BBC', linewidth=2)
ax.set_title('Transparent Background',
color='white', fontsize=14)
ax.tick_params(colors='white')
# PNG con fondo transparente
fig.savefig('ejemplo_transparent.png',
transparent=True, # Fondo transparente
dpi=150, bbox_inches='tight')
# SVG también admite transparencia
fig.savefig('ejemplo_transparent.svg',
transparent=True,
bbox_inches='tight')
print("ejemplo: transparent images saved")
plt.show()
Ejemplo 4: Guardado por lotes de múltiples subplots
Ejemplo
import numpy as np
# Crear una figura grande con varios gráficos
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'Series {i+1}')
ax.set_xlabel('Step')
ax.set_ylabel('Cumulative Sum')
ax.grid(True, alpha=0.3)
# Guardado por lotes, el nombre del archivo incluye el índice
fig.savefig(f'ejemplo_series_{i+1}.png',
dpi=200, bbox_inches='tight')
plt.close(fig) # Cerrar para evitar que se muestre
print("ejemplo: 4 figures saved (series_1 to series_4)")
Preguntas frecuentes
¿La imagen guardada está en blanco?
Compruebe si savefig() se llama después de show(). show() puede vaciar la Figure.
Solución: llame a savefig() antes de show(), o usefig.savefig()para especificar un objeto Figure.
¿El texto/las etiquetas en la imagen se recortan?
Usebbox_inches='tight'el recorte automático, que asegura que todos los elementos estén dentro de la imagen.
Si aún hay problemas, puede aumentarpad_inchesel valor del parámetro.
Otras extensiones