matplotlib.pyplot.savefig #
- matplotlib.pyplot. savefig ( * args , ** kwargs ) [source] #
Enregistrez la figure actuelle.
Signature d'appel :
savefig(fname, *, dpi='figure', format=None, metadata=None, bbox_inches=None, pad_inches=0.1, facecolor='auto', edgecolor='auto', backend=None, **kwargs )
Les formats de sortie disponibles dépendent du backend utilisé.
- Paramètres :
- fname str ou comme un chemin ou comme un fichier binaire
Un chemin ou un objet semblable à un fichier Python, ou éventuellement un objet dépendant du backend tel que
matplotlib.backends.backend_pdf.PdfPages.Si format est défini, il détermine le format de sortie et le fichier est enregistré sous fname . Notez que fname est utilisé textuellement et qu'il n'y a aucune tentative de faire en sorte que l'extension, le cas échéant, de fname corresponde à format , et aucune extension n'est ajoutée.
Si format n'est pas défini, le format est déduit de l'extension de fname , s'il y en a une. Si le format n'est pas défini et que fname n'a pas d'extension, le fichier est enregistré avec
rcParams["savefig.format"](par défaut :'png') et l'extension appropriée est ajoutée à fname .
- Autres paramètres :
- dpi float ou 'figure', par défaut :
rcParams["savefig.dpi"](par défaut :'figure') La résolution en points par pouce. Si 'figure', utilisez la valeur dpi de la figure.
- chaîne de format
Le format de fichier, par exemple 'png', 'pdf', 'svg', ... Le comportement lorsque ceci n'est pas défini est documenté sous fname .
- dict de métadonnées , facultatif
Paires clé/valeur à stocker dans les métadonnées de l'image. Les clés et les valeurs par défaut prises en charge dépendent du format d'image et du backend :
- bbox_inches str ou
Bbox, par défaut :rcParams["savefig.bbox"](par défaut :None) Boîte englobante en pouces : seule la partie donnée de la figure est enregistrée. Si 'serré', essayez de trouver la bbox serrée de la figure.
- pad_inches flottant, par défaut :
rcParams["savefig.pad_inches"](par défaut :0.1) Quantité de rembourrage autour de la figure lorsque bbox_inches est 'serré'.
- couleur de facecolor ou 'auto', par défaut :
rcParams["savefig.facecolor"](par défaut :'auto') La couleur de face de la figure. Si 'auto', utilise la couleur de face actuelle de la figure.
- edgecolor color ou 'auto', par défaut :
rcParams["savefig.edgecolor"](par défaut :'auto') La couleur de bord de la figure. Si 'auto', utilise la couleur de bord actuelle de la figure.
- backend str, facultatif
Utilisez un backend non par défaut pour rendre le fichier, par exemple pour rendre un fichier png avec le backend "cairo" plutôt que le "agg" par défaut, ou un fichier pdf avec le backend "pgf" plutôt que le "pdf" par défaut. Notez que le backend par défaut est normalement suffisant. Voir Les backends intégrés pour une liste des backends valides pour chaque format de fichier. Les backends personnalisés peuvent être référencés comme "module://...".
- orientation {'paysage', 'portrait'}
Actuellement uniquement pris en charge par le backend postscript.
- type de papier str
Un parmi 'lettre', 'légal', 'exécutif', 'grand livre', 'a0' à 'a10', 'b0' à 'b10'. Uniquement pris en charge pour la sortie postscript.
- booléen transparent
Si True , les patchs Axes seront tous transparents ; le patch Figure sera également transparent à moins que la couleur de face et/ou la couleur de bord ne soient spécifiées via kwargs .
Si False n'a aucun effet et que la couleur des patchs Axes et Figure reste inchangée (sauf si le patch Figure est spécifié via les arguments de mot-clé facecolor et/ou edgecolor , auquel cas ces couleurs sont utilisées).
La transparence de ces patchs sera restaurée à leurs valeurs d'origine à la sortie de cette fonction.
Ceci est utile, par exemple, pour afficher un tracé sur un arrière-plan coloré sur une page Web.
- bbox_extra_artists liste de
Artist, facultatif Une liste d'artistes supplémentaires qui seront pris en compte lors du calcul de la bbox serrée.
- pil_kwargs dict, facultatif
Arguments de mots clés supplémentaires qui sont transmis à
PIL.Image.Image.savelors de l'enregistrement de la figure.
- dpi float ou 'figure', par défaut :
