Función Matplotlib savefig()


Matplotlib 参考文档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ámetroTipoDescripción
fnamestr, Path o file-likeNombre de archivo de salida u objeto de archivo. La extensión determina automáticamente el formato, como 'plot.png', 'plot.pdf', 'plot.svg'
dpifloat 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)
formatstrFormato de salida, como 'png', 'pdf', 'svg', 'eps', 'jpg'. Si no se especifica, se deduce del nombre del archivo
bbox_inchesstr o BboxLímites de recorte: 'tight' (recorte ajustado, elimina espacios en blanco adicionales), None (usa el tamaño original de la Figure)
pad_inchesfloatRelleno interior (en pulgadas) cuando bbox_inches='tight', por defecto 0.1
facecolorcolor o 'auto'Color de fondo de la imagen de salida; 'auto' usa el facecolor de la Figure
edgecolorcolor o 'auto'Color del borde de la imagen de salida
transparentboolSi es True, el fondo se establece como transparente (solo png/svg)
metadatadictMetadatos que se escriben en el archivo (soportados por algunos formatos)

Debeplt.show()llamarse antessavefig(), porque show() vacía la Figure. O usefig.savefig()para especificar un objeto Figure.

Formatos de archivo compatibles

FormatoExtensiónCaracterísticas
PNG.pngMapa de bits, admite transparencia, el más común
PDF.pdfGráfico vectorial, adecuado para publicaciones, se puede incrustar en LaTeX
SVG.svgGráfico vectorial, editable en navegadores/editores
EPS.epsGráfico vectorial, formato tradicional de publicación
JPEG.jpg / .jpegMapa de bits, compresión con pérdida, archivo pequeño pero no admite transparencia
TIFF.tiff / .tifMapa de bits, sin pérdida, adecuado para archivo

Ejemplos de uso

Ejemplo 1: Guardado básico

Ejemplo

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()

# 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 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('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 matplotlib.pyplot as plt
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 matplotlib.pyplot as plt
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.


Matplotlib 参考文档Documentación de referencia de Matplotlib

Otras extensiones