matplotlib.image

画像モジュールは、基本的な画像の読み込み、再スケーリング、および表示操作をサポートしています。

クラス matplotlib.image. AxesImage ( ax , * , cmap =なし, norm =なし, interpolation =なし, origin =なし, extent =なし, filternorm = True , filterrad = 4.0 , resample = False , interpolation_stage =なし, ** kwargs )

拠点:_ImageBase

Axes に添付されたイメージ。

パラメータ:

斧Axes

画像が属する軸。

cmap str またはColormap、デフォルト: rcParams["image.cmap"](デフォルト: 'viridis')

スカラー データを色にマップするために使用される Colormap インスタンスまたは登録済みのカラーマップ名。

ノルムstr またはNormalize

輝度を 0 ～ 1 にマップします。

補間文字列、デフォルト: rcParams["image.interpolation"](デフォルト: 'antialiased')

サポートされている値は、'none'、'antialiased'、'nearest'、'bilinear'、'bicubic'、'spline16'、'spline36'、'hanning'、'hamming'、'hermite'、'kaiser'、'quadric' です。 、「catrom」、「gaussian」、「bessel」、「mitchell」、「sinc」、「lanczos」、「blackman」。

Interpolation_stage {'data', 'rgba'}, デフォルト: 'data'

'data' の場合、ユーザーから提供されたデータに対して補間が実行されます。'rgba' の場合、カラーマッピングが適用された後に補間が実行されます (ビジュアル補間)。

origin {'upper', 'lower'}, デフォルト: rcParams["image.origin"](デフォルト: 'upper')

配列の [0, 0] インデックスを座標軸の左上隅または左下隅に配置します。'upper' という規則は通常、行列と画像に使用されます。

範囲タプル、オプション

データ プロットに登録されたイメージ プロットを作成するためのデータ軸 (左、右、下、上)。デフォルトでは、ゼロベースの行と列のインデックスでピクセルの中心にラベルを付けます。

filternorm bool、デフォルト: True

アンチグレイン画像サイズ変更フィルターのパラメーター (アンチグレインのドキュメントを参照)。filternorm が設定されている場合、フィルターは整数値を正規化し、丸め誤差を修正します。ソースの浮動小数点値には何もせず、1.0 の規則に従って整数のみを修正します。つまり、ピクセルの重みの合計は 1.0 に等しくなければなりません。したがって、フィルター関数は適切な形状のグラフを生成する必要があります。

filterrad float > 0、デフォルト: 4

半径パラメーターを持つフィルターのフィルター半径。つまり、補間が 'sinc'、'lanczos'、または 'blackman' のいずれかである場合。

リサンプルブール値、デフォルト: False

True の場合、完全なリサンプリング メソッドを使用します。False の場合、出力イメージが入力イメージより大きい場合にのみリサンプリングします。

**kwargsArtistプロパティ

パラメータ:

norm Normalize(またはそのサブクラス) または str または None

通常、データを interval にスケーリングする正規化オブジェクト。の場合、対応する名前のスケールに基づいてサブクラスが動的に生成されます。Noneの場合、ノルムはデフォルトで、処理された最初のデータに基づいてスケーリングを初期化するcolors.Normalizeオブジェクトになります。[0, 1]strNormalize

cmap str またはColormap

正規化されたデータ値を RGBA カラーにマップするために使用されるカラーマップ。

get_cursor_data (イベント)

イベント位置の画像値を返すか、イベントが画像の外にある場合はNoneを返します。

こちらもご覧ください

matplotlib.artist.Artist.get_cursor_data

get_extent ( )

画像範囲をタプル (左、右、下、上) として返します。

get_window_extent ( renderer = None )

表示スペースでアーティストのバウンディング ボックスを取得します。

境界ボックスの幅と高さは負ではありません。

サブクラスは、境界ボックスの「タイトな」計算に含めるためにオーバーライドする必要があります。デフォルトでは、0, 0 で空のバウンディング ボックスを返します。

この関数を使用するときは注意してください。アーティストのアーティスト ウィンドウ範囲が変更された場合、結果は更新されません。範囲は、座標軸の範囲、Figure のサイズ、または使用されるキャンバス (Figure の保存時に行われる) の変更など、変換スタック内の変更によって変更される可能性があります。これにより、インタラクティブな Figure が画面上で正常に表示されても、正しく保存されないという予期しない動作が発生する可能性があります。

make_image ( renderer、倍率= 1.0、サンプリングされていない= False )

指定された倍率でrendererを使用してレンダリングするために、このイメージのデータを正規化、再スケーリング、およびカラーマップし ます。

unsampledが True の場合、画像はスケーリングされませんが、代わりに適切なアフィン変換が返されます。

戻り値:

画像(M, N, 4) uint8 配列

サンプリングされていない場合を除き、再サンプリングされた RGBA イメージが True です。

x、yフロート

画像を描画する左上隅 (ピクセル空間)。

trans Affine2D

画像からピクセル空間へのアフィン変換。

set ( * , agg_filter=<UNSET> , alpha=<UNSET > , animation=<UNSET > , array=<UNSET> , clim=<UNSET> , clip_box=<UNSET> , clip_on=<UNSET> , clip_path=<UNSET >、 cmap=<UNSET>、 data=<UNSET>、 extent=< UNSET> 、 filternorm=<UNSET >、 filterrad=<UNSET>、 gid=<UNSET>、 in_layout=<UNSET>、 interpolation=<UNSET>、補間ステージ=<UNSET> ,label=<未設定> ,mouseover=<UNSET> , norm=<UNSET> , path_effects=<UNSET> , picker=<UNSET > , rasterized=< UNSET> , resample=<UNSET> , sketch_params=<UNSET> , snap=<UNSET> , transform= <UNSET> , url=<UNSET> , visible=<UNSET> , zorder=<UNSET> )

一度に複数のプロパティを設定します。

サポートされているプロパティは

財産	説明
agg_filter	(m, n, 3) float 配列と dpi 値を取り、(m, n, 3) 配列と画像の左下隅からの 2 つのオフセットを返すフィルター関数
alpha	float または 2D 配列のようなものまたは None
animated	ブール
array	配列のような
clim	(vmin: float、vmax: float)
clip_box	Bbox
clip_on	ブール
clip_path	パッチまたは (パス、変換) またはなし
cmap	Colormapまたは str または None
data	配列のようなまたはPIL.Image.Image
extent	float の 4 タプル
figure	Figure
filternorm	ブール
filterrad	プラスフロート
gid	力
in_layout	ブール
interpolation	{'antialiased', 'nearest', 'bilinear', 'bicubic', 'spline16', 'spline36', 'hanning', 'hamming', 'hermite', 'kaiser', 'quadric', 'catrom', ' gaussian'、'bessel'、'mitchell'、'sinc'、'lanczos'、'none'} または None
interpolation_stage	{'data', 'rgba'} または None
label	物体
mouseover	ブール
norm	Normalizeまたは str または None
path_effects	AbstractPathEffect
picker	None または bool または float または callable
rasterized	ブール
resample	ブールまたはなし
sketch_params	(位取り: float、長さ: float、乱数: float)
snap	ブールまたはなし
transform	Transform
url	力
visible	ブール
zorder	浮く

set_extent (エクステント)

画像範囲を設定します。

パラメータ:

float のエクステント4 タプル

データ座標のタプルとしてのイメージの位置とサイズ 。(left, right, bottom, top)

ノート

これにより が更新されax.dataLim、自動スケーリングの場合はax.viewLim 、 に関係なく画像にぴったり合うように設定されdataLimます。自動スケーリングの状態は変更されないため、これに続くとax.autoscale_view() 、に従って自動スケーリングがやり直されdataLimます。

クラス matplotlib.image. BboxImage ( bbox , * , cmap =なし, norm =なし, interpolation =なし, origin =なし, filternorm = True , filterrad = 4.0 , resample = False , ** kwargs )

拠点:_ImageBase

指定された bbox によってサイズが決定される Image クラス。

cmap は色です。Colormap インスタンスのノルムは色です。インスタンスを正規化し、輝度を 0 ～ 1 にマップします。

kwargs はアーティストのキーワード引数のオプションのリストです

含む(マウスイベント)

画像内でマウス イベントが発生したかどうかをテストします。

get_window_extent ( renderer = None )

表示スペースでアーティストのバウンディング ボックスを取得します。

境界ボックスの幅と高さは負ではありません。

サブクラスは、境界ボックスの「タイトな」計算に含めるためにオーバーライドする必要があります。デフォルトでは、0, 0 で空のバウンディング ボックスを返します。

この関数を使用するときは注意してください。アーティストのアーティスト ウィンドウ範囲が変更された場合、結果は更新されません。範囲は、座標軸の範囲、Figure のサイズ、または使用されるキャンバス (Figure の保存時に行われる) の変更など、変換スタック内の変更によって変更される可能性があります。これにより、インタラクティブな Figure が画面上で正常に表示されても、正しく保存されないという予期しない動作が発生する可能性があります。

make_image ( renderer、倍率= 1.0、サンプリングされていない= False )

指定された倍率でrendererを使用してレンダリングするために、このイメージのデータを正規化、再スケーリング、およびカラーマップし ます。

unsampledが True の場合、画像はスケーリングされませんが、代わりに適切なアフィン変換が返されます。

戻り値:

画像(M, N, 4) uint8 配列

サンプリングされていない場合を除き、再サンプリングされた RGBA イメージが True です。

x、yフロート

画像を描画する左上隅 (ピクセル空間)。

trans Affine2D

画像からピクセル空間へのアフィン変換。

set ( * , agg_filter=<UNSET> , alpha=<UNSET > , animation=<UNSET > , array=<UNSET> , clim=<UNSET> , clip_box=<UNSET> , clip_on=<UNSET> , clip_path=<UNSET >、 cmap=<UNSET>、 data=<UNSET > 、 filternorm=<UNSET >、 filterrad=<UNSET>、 gid=<UNSET>、 in_layout=<UNSET>、 interpolation=<UNSET>、 interpolation_stage=<UNSET>、 label=<未設定> ,mouseover=<UNSET> ,norm=<UNSET> , path_effects=<UNSET> , picker=<UNSET > , rasterized=< UNSET> , resample=<UNSET> , sketch_params=<UNSET> , snap=<UNSET> , transform=<UNSET> , url= <UNSET> , visible=<UNSET> , zorder=<UNSET> )

一度に複数のプロパティを設定します。

サポートされているプロパティは

財産	説明
agg_filter	(m, n, 3) float 配列と dpi 値を取り、(m, n, 3) 配列と画像の左下隅からの 2 つのオフセットを返すフィルター関数
alpha	float または 2D 配列のようなものまたは None
animated	ブール
array	配列のような
clim	(vmin: float、vmax: float)
clip_box	Bbox
clip_on	ブール
clip_path	パッチまたは (パス、変換) またはなし
cmap	Colormapまたは str または None
data	配列のようなまたはPIL.Image.Image
figure	Figure
filternorm	ブール
filterrad	プラスフロート
gid	力
in_layout	ブール
interpolation	{'antialiased', 'nearest', 'bilinear', 'bicubic', 'spline16', 'spline36', 'hanning', 'hamming', 'hermite', 'kaiser', 'quadric', 'catrom', ' gaussian'、'bessel'、'mitchell'、'sinc'、'lanczos'、'none'} または None
interpolation_stage	{'data', 'rgba'} または None
label	物体
mouseover	ブール
norm	Normalizeまたは str または None
path_effects	AbstractPathEffect
picker	None または bool または float または callable
rasterized	ブール
resample	ブールまたはなし
sketch_params	(位取り: float、長さ: float、乱数: float)
snap	ブールまたはなし
transform	Transform
url	力
visible	ブール
zorder	浮く

クラス matplotlib.image. FigureImage ( fig , * , cmap =なし, norm =なし, offsetx = 0 , offsety = 0 , origin =なし, ** kwargs )

拠点:_ImageBase

フィギュアに貼り付けた画像です。

cmap は色です。Colormap インスタンスのノルムは色です。インスタンスを正規化し、輝度を 0 ～ 1 にマップします。

kwargs はアーティストのキーワード引数のオプションのリストです

get_extent ( )

画像範囲をタプル (左、右、下、上) として返します。

make_image ( renderer、倍率= 1.0、サンプリングされていない= False )

指定された倍率でrendererを使用してレンダリングするために、このイメージのデータを正規化、再スケーリング、およびカラーマップし ます。

unsampledが True の場合、画像はスケーリングされませんが、代わりに適切なアフィン変換が返されます。

戻り値:

画像(M, N, 4) uint8 配列

サンプリングされていない場合を除き、再サンプリングされた RGBA イメージが True です。

x、yフロート

画像を描画する左上隅 (ピクセル空間)。

trans Affine2D

画像からピクセル空間へのアフィン変換。

set ( * , agg_filter=<UNSET> , alpha=<UNSET > , animation=<UNSET > , array=<UNSET> , clim=<UNSET> , clip_box=<UNSET> , clip_on=<UNSET> , clip_path=<UNSET >、 cmap=<UNSET>、 data=<UNSET > 、 filternorm=<UNSET >、 filterrad=<UNSET>、 gid=<UNSET>、 in_layout=<UNSET>、 interpolation=<UNSET>、 interpolation_stage=<UNSET>、 label=<未設定> ,mouseover=<UNSET> ,norm=<UNSET> , path_effects=<UNSET> , picker=<UNSET > , rasterized=< UNSET> , resample=<UNSET> , sketch_params=<UNSET> , snap=<UNSET> , transform=<UNSET> , url= <UNSET> , visible=<UNSET> , zorder=<UNSET> )

一度に複数のプロパティを設定します。

サポートされているプロパティは

財産	説明
agg_filter	(m, n, 3) float 配列と dpi 値を取り、(m, n, 3) 配列と画像の左下隅からの 2 つのオフセットを返すフィルター関数
alpha	float または 2D 配列のようなものまたは None
animated	ブール
array	配列のような
clim	(vmin: float、vmax: float)
clip_box	Bbox
clip_on	ブール
clip_path	パッチまたは (パス、変換) またはなし
cmap	Colormapまたは str または None
data	わからない
figure	Figure
filternorm	ブール
filterrad	プラスフロート
gid	力
in_layout	ブール
interpolation	{'antialiased', 'nearest', 'bilinear', 'bicubic', 'spline16', 'spline36', 'hanning', 'hamming', 'hermite', 'kaiser', 'quadric', 'catrom', ' gaussian'、'bessel'、'mitchell'、'sinc'、'lanczos'、'none'} または None
interpolation_stage	{'data', 'rgba'} または None
label	物体
mouseover	ブール
norm	Normalizeまたは str または None
path_effects	AbstractPathEffect
picker	None または bool または float または callable
rasterized	ブール
resample	ブールまたはなし
sketch_params	(位取り: float、長さ: float、乱数: float)
snap	ブールまたはなし
transform	Transform
url	力
visible	ブール
zorder	浮く

set_data ( A )

画像配列を設定します。

ズオーダ= 0

クラス matplotlib.image. NonUniformImage ( ax , * , interpolation = 'nearest' , ** kwargs )

拠点:AxesImage

パラメータ:

補間{'nearest', 'bilinear'}, デフォルト: 'nearest'

**kwargs

他のすべてのキーワード引数は、AxesImage.

get_extent ( )

画像範囲をタプル (左、右、下、上) として返します。

make_image ( renderer、倍率= 1.0、サンプリングされていない= False )

指定された倍率でrendererを使用してレンダリングするために、このイメージのデータを正規化、再スケーリング、およびカラーマップし ます。

unsampledが True の場合、画像はスケーリングされませんが、代わりに適切なアフィン変換が返されます。

戻り値:

画像(M, N, 4) uint8 配列

サンプリングされていない場合を除き、再サンプリングされた RGBA イメージが True です。

x、yフロート

画像を描画する左上隅 (ピクセル空間)。

trans Affine2D

画像からピクセル空間へのアフィン変換。

マウスオーバー=偽

set ( * , agg_filter=<UNSET> , alpha=<UNSET > , animation=<UNSET > , array=<UNSET> , clim=<UNSET> , clip_box=<UNSET> , clip_on=<UNSET> , clip_path=<UNSET >、 cmap=<UNSET>、 data=<UNSET>、 extent=< UNSET> 、 filternorm=<UNSET >、 filterrad=<UNSET>、 gid=<UNSET>、 in_layout=<UNSET>、 interpolation=<UNSET>、補間ステージ=<UNSET> ,label=<未設定> ,mouseover=<UNSET> , norm=<UNSET> , path_effects=<UNSET> , picker=<UNSET > , rasterized=< UNSET> , resample=<UNSET> , sketch_params=<UNSET> , snap=<UNSET> , transform= <UNSET> , url=<UNSET> , visible=<UNSET> , zorder=<UNSET> )

一度に複数のプロパティを設定します。

サポートされているプロパティは

財産	説明
agg_filter	(m, n, 3) float 配列と dpi 値を取り、(m, n, 3) 配列と画像の左下隅からの 2 つのオフセットを返すフィルター関数
alpha	float または 2D 配列のようなものまたは None
animated	ブール
array	わからない
clim	(vmin: float、vmax: float)
clip_box	Bbox
clip_on	ブール
clip_path	パッチまたは (パス、変換) またはなし
cmap	わからない
data	わからない
extent	float の 4 タプル
figure	Figure
filternorm	わからない
filterrad	わからない
gid	力
in_layout	ブール
interpolation	{'nearest', 'bilinear'} または None
interpolation_stage	{'data', 'rgba'} または None
label	物体
mouseover	ブール
norm	わからない
path_effects	AbstractPathEffect
picker	None または bool または float または callable
rasterized	ブール
resample	ブールまたはなし
sketch_params	(位取り: float、長さ: float、乱数: float)
snap	ブールまたはなし
transform	Transform
url	力
visible	ブール
zorder	浮く

set_array ( * args )

下位互換性のために残されています - 代わりに set_data を使用してください。

パラメータ:

配列のような

set_cmap ( cmap )

輝度データのカラーマップを設定します。

パラメータ:

cmapColormapまたは str または None

set_data ( x , y , A )

ピクセル中心のグリッドとピクセル値を設定します。

パラメータ:

x, y 1D 配列のようなもの

それぞれ形状 (N,) および (M,) の単調配列で、ピクセルの中心を指定します。

配列のような

(M, N) カラーマップされる値の ndarray またはマスクされた配列、または (M, N, 3) RGB 配列、または (M, N, 4) RGBA 配列。

set_filternorm ( s )

サイズ変更フィルターがウェイトを正規化するかどうかを設定します。

のヘルプを参照してくださいimshow。

パラメータ:

フィルターノルムブール

set_filterrad ( s )

一部の補間スキームにのみ適用可能なサイズ変更フィルタの半径を設定します -- imshow のヘルプを参照してください

パラメータ:

filterradポジティブフロート

set_interpolation ( s )

パラメータ:

s {'nearest', 'bilinear'} または None

None の場合はrcParams["image.interpolation"](デフォルト: 'antialiased') を使用します。

set_norm (ノルム)

正規化インスタンスを設定します。

パラメータ:

normNormalizeまたは str または None

ノート

このノルムにマッピング可能を使用するカラーバーがある場合、マッピング可能のノルムを設定すると、カラーバーのノルム、ロケーター、およびフォーマッターがデフォルトにリセットされます。

クラス matplotlib.image. PcolorImage ( ax , x =なし, y =なし, A =なし, * , cmap =なし, norm =なし, ** kwargs )

拠点:AxesImage

不規則な長方形のグリッドで pcolor スタイルのプロットを作成します。

これは元の不規則なイメージ コードのバリエーションを使用し、対応するグリッド タイプに対して pcolorfast によって使用されます。

パラメータ:

斧Axes

画像が属する軸。

x, y 1D 配列のようなもの、オプション

それぞれ長さ N+1 および M+1 のモノトニック配列で、四角形の境界を指定します。指定しない場合、デフォルト でそれぞれとになります。range(N + 1)range(M + 1)

配列のような

色分けするデータ。解釈は形状によって異なります。

• (M, N) ndarray またはマスクされた配列: カラーマップされる値

• (M, N, 3): RGB配列

• (M、N、4): RGBA配列

cmap str またはColormap、デフォルト: rcParams["image.cmap"](デフォルト: 'viridis')

スカラー データを色にマップするために使用される Colormap インスタンスまたは登録済みのカラーマップ名。

ノルムstr またはNormalize

輝度を 0 ～ 1 にマップします。

**kwargsArtistプロパティ

get_cursor_data (イベント)

イベント位置の画像値を返すか、イベントが画像の外にある場合はNoneを返します。

こちらもご覧ください

matplotlib.artist.Artist.get_cursor_data

make_image ( renderer、倍率= 1.0、サンプリングされていない= False )

指定された倍率でrendererを使用してレンダリングするために、このイメージのデータを正規化、再スケーリング、およびカラーマップし ます。

unsampledが True の場合、画像はスケーリングされませんが、代わりに適切なアフィン変換が返されます。

戻り値:

画像(M, N, 4) uint8 配列

サンプリングされていない場合を除き、再サンプリングされた RGBA イメージが True です。

x、yフロート

画像を描画する左上隅 (ピクセル空間)。

trans Affine2D

画像からピクセル空間へのアフィン変換。

set ( * , agg_filter=<UNSET> , alpha=<UNSET > , animation=<UNSET > , array=<UNSET> , clim=<UNSET> , clip_box=<UNSET> , clip_on=<UNSET> , clip_path=<UNSET >、 cmap=<UNSET>、 data=<UNSET>、 extent=< UNSET> 、 filternorm=<UNSET >、 filterrad=<UNSET>、 gid=<UNSET>、 in_layout=<UNSET>、 interpolation=<UNSET>、補間ステージ=<UNSET> ,label=<未設定> ,mouseover=<UNSET> , norm=<UNSET> , path_effects=<UNSET> , picker=<UNSET > , rasterized=< UNSET> , resample=<UNSET> , sketch_params=<UNSET> , snap=<UNSET> , transform= <UNSET> , url=<UNSET> , visible=<UNSET> , zorder=<UNSET> )

一度に複数のプロパティを設定します。

サポートされているプロパティは

財産	説明
agg_filter	(m, n, 3) float 配列と dpi 値を取り、(m, n, 3) 配列と画像の左下隅からの 2 つのオフセットを返すフィルター関数
alpha	float または 2D 配列のようなものまたは None
animated	ブール
array	わからない
clim	(vmin: float、vmax: float)
clip_box	Bbox
clip_on	ブール
clip_path	パッチまたは (パス、変換) またはなし
cmap	Colormapまたは str または None
data	わからない
extent	float の 4 タプル
figure	Figure
filternorm	ブール
filterrad	プラスフロート
gid	力
in_layout	ブール
interpolation	{'antialiased', 'nearest', 'bilinear', 'bicubic', 'spline16', 'spline36', 'hanning', 'hamming', 'hermite', 'kaiser', 'quadric', 'catrom', ' gaussian'、'bessel'、'mitchell'、'sinc'、'lanczos'、'none'} または None
interpolation_stage	{'data', 'rgba'} または None
label	物体
mouseover	ブール
norm	Normalizeまたは str または None
path_effects	AbstractPathEffect
picker	None または bool または float または callable
rasterized	ブール
resample	ブールまたはなし
sketch_params	(位取り: float、長さ: float、乱数: float)
snap	ブールまたはなし
transform	Transform
url	力
visible	ブール
zorder	浮く

set_array ( * args )

下位互換性のために残されています - 代わりに set_data を使用してください。

パラメータ:

配列のような

set_data ( x , y , A )

四角形の境界のグリッドとデータ値を設定します。

パラメータ:

x, y 1D 配列のようなもの、オプション

それぞれ長さ N+1 および M+1 のモノトニック配列で、四角形の境界を指定します。指定しない場合、デフォルト でそれぞれとになります。range(N + 1)range(M + 1)

配列のような

色分けするデータ。解釈は形状によって異なります。

• (M, N) ndarray またはマスクされた配列: カラーマップされる値

• (M, N, 3): RGB配列

• (M、N、4): RGBA配列

matplotlib.image. composite_images (画像,レンダラー,倍率= 1.0 )

複数の RGBA イメージを 1 つに合成します。画像は、画像リストに表示されている順序で合成されます。

パラメータ:

画像一覧

それぞれにmake_imageメソッドが必要です。画像ごとに can_compositeを返す必要がTrueありますが、これはこの関数によって強制されません。各画像には、せん断のない純粋なアフィン変換が必要です。

レンダラーRendererBase

倍率フロート、デフォルト: 1

使用中のレンダラーに適用する追加の倍率。

戻り値:

画像uint8 配列 (M、N、4)

合成された RGBA 画像。

offset_x、offset_y float

出力 Figure 内で合成イメージを配置する (左、下) オフセット。

matplotlib.image. imread ( fname , format = None )

ファイルから配列にイメージを読み取ります。

ノート

この関数は歴史的な理由から存在します。PIL.Image.open画像の読み込みには代わりに使用することをお勧めします。

パラメータ:

fname str または file-like

読み取るイメージ ファイル: ファイル名、URL、または読み取りバイナリ モードで開かれたファイルのようなオブジェクト。

URL を渡すことは非推奨です。読み取り用の URL を開き、結果を などで Pillow に渡します np.array(PIL.Image.open(urllib.request.urlopen(url)))。

フォーマット文字列、オプション

データ読み込み時に想定される画像ファイル形式。formatが「png」に設定されている場合、fnameが「.png」拡張子を持つパスまたは開かれたファイルである場合、または URL である場合、画像は PNG ファイルとしてロードされます。それ以外の場合はすべて、フォーマットは無視され、フォーマットは によって自動検出され PIL.Image.openます。

戻り値:

numpy.array

画像データです。返された配列には形状があります

• (M, N) グレースケール イメージの場合。

• (M, N, 3) RGB イメージの場合。

• (M, N, 4) RGBA イメージの場合。

PNG 画像は float 配列 (0-1) として返されます。他のすべての形式は int 配列として返され、ビット深度はファイルの内容によって決定されます。

matplotlib.image. imsave ( fname , arr , vmin =なし, vmax =なし, cmap =なし, format =なし, origin =なし, dpi = 100 , * ,メタデータ=なし, pil_kwargs =なし)

配列をイメージ ファイルとして保存します。

パラメータ:

fname str またはパス状またはファイル状

画像を保存するパスまたはファイルのようなオブジェクト。formatが設定されていない場合、出力形式はfnameの拡張子 (存在する場合) から推測され、それ以外の場合はrcParams["savefig.format"](デフォルト: 'png') から推測されます。formatが設定されている場合、出力形式が決まります。

arr配列のような

画像データです。形状は、MxN (輝度)、MxNx3 (RGB)、または MxNx4 (RGBA) のいずれかです。

vmin、vmax float、オプション

vminとvmaxは、カラーマップの色の範囲に対応する値を固定することで、イメージの色のスケーリングを設定します。vmin またはvmaxのいずれかが None の場合、その制限はarr min/max 値から決定されます。

cmap str またはColormap、デフォルト: rcParams["image.cmap"](デフォルト: 'viridis')

Colormap インスタンスまたは登録済みのカラーマップ名。colormap は、スカラー データを色にマップします。RGB(A) データの場合は無視されます。

フォーマット文字列、オプション

'png'、'pdf'、'svg' などのファイル形式。これが設定されていない場合の動作は、fnameの下に記載されています。

origin {'upper', 'lower'}, デフォルト: rcParams["image.origin"](デフォルト: 'upper')

配列のインデックスが座標軸の左上隅または左下隅のどちらにあるかを示します。(0, 0)

dpiフロート

ファイルのメタデータに格納する DPI。これは、出力イメージの解像度には影響しません。ファイル形式によっては、最も近い整数に丸められる場合があります。

メタデータ辞書、オプション

画像ファイルのメタデータ。サポートされているキーは出力形式によって異なります。詳細については、それぞれのバックエンドのドキュメントを参照してください。

pil_kwargs dict、オプション

に渡されるキーワード引数PIL.Image.Image.save。「pnginfo」キーが存在する場合、デフォルトの「Software」キーを含むメタデータを完全にオーバーライドします。

matplotlib.image. pil_to_array ( pilImage )

PIL イメージをロードし、それを numpy int 配列として返します。

戻り値:

numpy.array

配列の形状は、画像の種類によって異なります。

• (M, N) グレースケール イメージの場合。

• (M, N, 3) RGB イメージの場合。

• (M, N, 4) RGBA イメージの場合。

matplotlib.image. サムネイル（infile、 thumbfile、 scale = 0.1、 interpolation = 'bilinear'、 preview = False）

出力ファイル名thumbfileを使用して、 infile内の画像のサムネイルを作成します。

画像のサムネイルを参照してください。

パラメータ:

infile str または file-like

画像ファイル。Matplotlib は、画像の読み取りをPillowに依存しているため、PNG、JPG、TIFF などの幅広いファイル形式をサポートしています。

サムファイル str または file-like

サムネイルのファイル名。

スケール浮動小数点数、デフォルト: 0.1

サムネイルの倍率。

補間str、既定: 'bilinear'

リサンプリングで使用される補間スキーム。可能な値については、 の補間パラメーターを参照してください imshow。

プレビューブール値、デフォルト: False

True の場合、既定のバックエンド (おそらくユーザー インターフェイス バックエンド) が使用され、 showが呼び出された場合に Figure が発生します。False の場合、Figure は を使用FigureCanvasBaseして作成され、描画バックエンドはFigure.savefig通常どおり選択されます。

戻り値:

Figure

サムネイルを含む Figure インスタンス。