matplotlib.pyplot.savefig #
- matplotlib.pyplot. savefig ( * argumentos , ** kwargs ) [fuente] #
Guarda la figura actual.
Firma de llamada:
savefig(fname, *, dpi='figure', format=None, metadata=None, bbox_inches=None, pad_inches=0.1, facecolor='auto', edgecolor='auto', backend=None, **kwargs )
Los formatos de salida disponibles dependen del backend que se utilice.
- Parámetros :
- fname str o similar a una ruta o similar a un archivo binario
Una ruta, o un objeto similar a un archivo de Python, o posiblemente algún objeto dependiente del back-end, como
matplotlib.backends.backend_pdf.PdfPages
.Si se establece el formato , determina el formato de salida y el archivo se guarda como fname . Tenga en cuenta que fname se usa palabra por palabra, y no se intenta hacer la extensión, si la hay, del formato de coincidencia de fname , y no se agrega ninguna extensión.
Si no se establece el formato , el formato se infiere de la extensión de fname , si existe. Si el formato no está configurado y fname no tiene extensión, entonces el archivo se guarda con
rcParams["savefig.format"]
(predeterminado:'png'
) y la extensión adecuada se agrega a fname .
- Otros parámetros :
- dpi flotante o 'cifra', predeterminado:
rcParams["savefig.dpi"]
(predeterminado:'figure'
) La resolución en puntos por pulgada. Si es 'cifra', utilice el valor de ppp de la cifra.
- cadena de formato
El formato de archivo, por ejemplo, 'png', 'pdf', 'svg', ... El comportamiento cuando esto no está configurado se documenta en fname .
- dictado de metadatos , opcional
Pares clave/valor para almacenar en los metadatos de la imagen. Las claves admitidas y los valores predeterminados dependen del formato de la imagen y el backend:
- bbox_inches str o
Bbox
, predeterminado:rcParams["savefig.bbox"]
(predeterminado:None
) Cuadro delimitador en pulgadas: solo se guarda la parte dada de la figura. Si está 'apretado', trate de averiguar el recuadro estrecho de la figura.
- pad_inches float, predeterminado:
rcParams["savefig.pad_inches"]
(predeterminado:0.1
) Cantidad de relleno alrededor de la figura cuando bbox_inches es 'ajustado'.
- color de cara o 'automático', predeterminado:
rcParams["savefig.facecolor"]
(predeterminado:'auto'
) El color de la cara de la figura. Si es 'automático', use el color de cara de la figura actual.
- edgecolor color o 'auto', predeterminado:
rcParams["savefig.edgecolor"]
(predeterminado:'auto'
) El color del borde de la figura. Si es 'auto', use el color de borde de la figura actual.
- backend str, opcional
Utilice un backend no predeterminado para representar el archivo, por ejemplo, para representar un archivo png con el backend "cairo" en lugar del "agg" predeterminado, o un archivo pdf con el backend "pgf" en lugar del "pdf" predeterminado. Tenga en cuenta que el backend predeterminado normalmente es suficiente. Consulte Los backends integrados para obtener una lista de backends válidos para cada formato de archivo. Se puede hacer referencia a los backends personalizados como "módulo://...".
- orientación {'paisaje', 'retrato'}
Actualmente solo es compatible con el backend postscript.
- tipo de papel str
Uno de 'carta', 'legal', 'ejecutivo', 'libro mayor', 'a0' a 'a10', 'b0' a 'b10'. Solo se admite para la salida de postscript.
- bool transparente
Si es True , todos los parches de Axes serán transparentes; el parche de la figura también será transparente a menos que se especifique el color de la cara y/o el color del borde a través de kwargs .
Si False no tiene ningún efecto y el color de los ejes y los parches de la figura no cambian (a menos que el parche de la figura se especifique a través de los argumentos de palabra clave facecolor y/o edgecolor , en cuyo caso se usan esos colores).
La transparencia de estos parches se restaurará a sus valores originales al salir de esta función.
Esto es útil, por ejemplo, para mostrar un gráfico sobre un fondo de color en una página web.
- bbox_extra_artists lista de
Artist
, opcional Una lista de artistas adicionales que se considerarán cuando se calcule el bbox ajustado.
- dictado de pil_kwargs , opcional
Argumentos de palabras clave adicionales que se pasan
PIL.Image.Image.save
al guardar la figura.
- dpi flotante o 'cifra', predeterminado:
Ejemplos usando matplotlib.pyplot.savefig
#
Rasterización para gráficos vectoriales
Información sobre herramientas SVG