matplotlib.pyplot.savefig #
- matplotlib.pyplot. savefig ( * args , ** kwargs ) [fonte] #
Salve a figura atual.
Assinatura de chamada:
savefig(fname, *, dpi='figure', format=None, metadata=None, bbox_inches=None, pad_inches=0.1, facecolor='auto', edgecolor='auto', backend=None, **kwargs )
Os formatos de saída disponíveis dependem do backend que está sendo usado.
- Parâmetros :
- fname str ou semelhante a um caminho ou semelhante a um arquivo binário
Um caminho, ou um objeto semelhante a um arquivo Python, ou possivelmente algum objeto dependente de back-end, como
matplotlib.backends.backend_pdf.PdfPages
.Se o formato for definido, ele determinará o formato de saída e o arquivo será salvo como fname . Observe que fname é usado literalmente e não há tentativa de fazer a extensão, se houver, de fname corresponder ao formato e nenhuma extensão é anexada.
Se o formato não for definido, o formato será inferido da extensão de fname , se houver. Se o formato não for definido e fname não tiver extensão, o arquivo será salvo com
rcParams["savefig.format"]
(padrão:'png'
) e a extensão apropriada será anexada a fname .
- Outros Parâmetros :
- dpi flutuante ou 'figura', padrão:
rcParams["savefig.dpi"]
(padrão:'figure'
) A resolução em pontos por polegada. Se for 'figura', use o valor dpi da figura.
- formato str
O formato do arquivo, por exemplo, 'png', 'pdf', 'svg', ... O comportamento quando não está definido está documentado em fname .
- dicionário de metadados , opcional
Pares chave/valor para armazenar nos metadados da imagem. As chaves e padrões suportados dependem do formato da imagem e do back-end:
- bbox_inches str ou
Bbox
, padrão:rcParams["savefig.bbox"]
(padrão:None
) Caixa delimitadora em polegadas: apenas a parte especificada da figura é salva. Se 'apertado', tente descobrir o bbox apertado da figura.
- pad_inches float, padrão:
rcParams["savefig.pad_inches"]
(padrão:0.1
) Quantidade de preenchimento ao redor da figura quando bbox_inches é 'apertado'.
- facecolor color ou 'auto', padrão:
rcParams["savefig.facecolor"]
(padrão:'auto'
) A cor da face da figura. Se for 'auto', use a cor do rosto da figura atual.
- cor da cor da borda ou 'auto', padrão:
rcParams["savefig.edgecolor"]
(padrão:'auto'
) A cor da borda da figura. Se for 'auto', use a cor de borda da figura atual.
- back- end str, opcional
Use um backend não padrão para renderizar o arquivo, por exemplo, para renderizar um arquivo png com o backend "cairo" em vez do padrão "agg" ou um arquivo pdf com o backend "pgf" em vez do "pdf" padrão. Observe que o back-end padrão normalmente é suficiente. Consulte Os back-ends integrados para obter uma lista de back-ends válidos para cada formato de arquivo. Os back-ends personalizados podem ser referenciados como "module://...".
- orientação {'paisagem', 'retrato'}
Atualmente suportado apenas pelo back-end postscript.
- tipo de papel str
Um de 'carta', 'legal', 'executivo', 'razão', 'a0' a 'a10', 'b0' a 'b10'. Suportado apenas para saída postscript.
- bool transparente
Se True , os patches de Axes serão todos transparentes; o patch da Figura também será transparente, a menos que a cor da face e/ou a cor da borda sejam especificadas por meio de kwargs.
Se False não tiver efeito e a cor dos patches Axes e Figure permanecerem inalteradas (a menos que o patch Figure seja especificado por meio dos argumentos de palavra-chave facecolor e/ou edgecolor , caso em que essas cores são usadas).
A transparência desses patches será restaurada aos seus valores originais ao sair desta função.
Isso é útil, por exemplo, para exibir um gráfico sobre um plano de fundo colorido em uma página da web.
- bbox_extra_artists lista de
Artist
, opcional Uma lista de artistas extras que serão considerados quando o bbox for calculado.
- ditado pil_kwargs , opcional
Argumentos de palavra-chave adicionais que são passados ao
PIL.Image.Image.save
salvar a figura.
- dpi flutuante ou 'figura', padrão:
Exemplos usando matplotlib.pyplot.savefig
#
Rasterização para gráficos vetoriais