matplotlib.pyplot.savefig #
- matplotlib.pyplot. savefig ( *引数, ** kwargs ) [ソース] #
現在の Figure を保存します。
呼び出し署名:
savefig(fname, *, dpi='figure', format=None, metadata=None, bbox_inches=None, pad_inches=0.1, facecolor='auto', edgecolor='auto', backend=None, **kwargs )
利用可能な出力形式は、使用されているバックエンドによって異なります。
- パラメータ:
- fname str またはパスのようなものまたはバイナリ ファイルのようなもの
パス、または Python ファイルのようなオブジェクト、あるいは
matplotlib.backends.backend_pdf.PdfPages
.formatが設定されている場合、出力形式が決定され、ファイルはfnameとして保存されます。fnameは逐語的に使用され、 fnameの拡張子があったとしてもformatに一致 するように試みられず、拡張子が追加されないことに注意してください。
formatが設定されていない場合、フォーマットはfnameの拡張子 (存在する場合) から推測されます。formatが設定されておらず、fnameに拡張子がない場合、ファイルは
rcParams["savefig.format"]
(デフォルト: )で保存'png'
され、適切な拡張子が fnameに追加されます。
- その他のパラメータ:
- dpi float または 'figure'、デフォルト:
rcParams["savefig.dpi"]
(デフォルト:'figure'
) ドット/インチの解像度。'figure' の場合、図の dpi 値を使用します。
- フォーマット文字列
'png'、'pdf'、'svg' などのファイル形式。これが設定されていない場合の動作は、fnameの下に記載されています。
- メタデータ辞書、オプション
イメージ メタデータに格納するキーと値のペア。サポートされているキーとデフォルトは、画像の形式とバックエンドによって異なります。
- bbox_inches str または
Bbox
、デフォルト:rcParams["savefig.bbox"]
(デフォルト:None
) インチ単位の境界ボックス: Figure の指定された部分のみが保存されます。'tight' の場合、Figure のタイトな bbox を見つけようとします。
- pad_inches float、デフォルト:
rcParams["savefig.pad_inches"]
(デフォルト:0.1
) bbox_inches が 'tight' の場合の図の周りのパディングの量。
- facecolor color または 'auto', デフォルト:
rcParams["savefig.facecolor"]
(デフォルト:'auto'
) フィギュアのフェイスカラー。'auto' の場合、現在の図の facecolor を使用します。
- edgecolor色または 'auto', デフォルト:
rcParams["savefig.edgecolor"]
(デフォルト:'auto'
) Figure のエッジカラー。'auto' の場合、現在の Figure のエッジカラーを使用します。
- バックエンド文字列、オプション
デフォルト以外のバックエンドを使用してファイルをレンダリングします。たとえば、デフォルトの「agg」ではなく「cairo」バックエンドで png ファイルをレンダリングしたり、デフォルトの「pdf」ではなく「pgf」バックエンドで pdf ファイルをレンダリングしたりします。通常、デフォルトのバックエンドで十分であることに注意してください。各ファイル形式の有効なバックエンドのリストについては、組み込みのバックエンドを参照 してください。カスタム バックエンドは「module://...」として参照できます。
- 向き{'横向き', '縦向き'}
現在、Postscript バックエンドでのみサポートされています。
- papertype str
'letter'、'legal'、'executive'、'ledger'、'a0' から 'a10'、'b0' から 'b10' のいずれか。Postscript 出力でのみサポートされています。
- 透明ブール
Trueの場合、Axes パッチはすべて透明になります。facecolor やedgecolorが kwargs で指定されていない限り、Figure パッチも透明になります。
Falseが無効で、Axes および Figure パッチの色が変更されていない場合 (Figure パッチがfacecolorおよび/またはedgecolorキーワード引数で指定されている場合を除きます。この場合、これらの色が使用されます)。
これらのパッチの透明度は、この関数の終了時に元の値に復元されます。
これは、たとえば、Web ページの色付きの背景の上にプロットを表示する場合に便利です。
- bbox_extra_artistsのリスト
Artist
、オプション タイトな bbox が計算されるときに考慮される追加のアーティストのリスト。
- pil_kwargs dict、オプション
PIL.Image.Image.save
Figure を保存するときに渡される追加のキーワード引数 。
- dpi float または 'figure'、デフォルト: