imgaussfilt

イメージの 2 次元ガウス フィルター処理

構文

B = imgaussfilt(A)

B = imgaussfilt(A,sigma)

B = imgaussfilt(___,Name=Value)

説明

B = imgaussfilt(A) は、標準偏差 0.5 の 2 次元ガウス平滑化カーネルでイメージ A をフィルター処理し、フィルター処理されたイメージを B に返します。

B = imgaussfilt(A,sigma) は、sigma で指定された標準偏差の 2 次元ガウス平滑化カーネルでイメージ A をフィルター処理します。

B = imgaussfilt(___,Name=Value) は、フィルター処理の特性を制御する名前と値の引数を使用します。

例

ガウス フィルターによるイメージの平滑化

フィルター処理するイメージを読み取ります。

I = imread("cameraman.tif");

標準偏差 2 の ガウス フィルターでイメージをフィルター処理します。

Iblur = imgaussfilt(I,2);

元のイメージとフィルター処理されたイメージをモンタージュに表示します。

montage({I,Iblur})
title("Original Image (Left) Vs. Gaussian Filtered Image (Right)")

入力引数

A — フィルター処理されるイメージ

数値配列

フィルター処理されるイメージ。任意の次元の数値配列として指定します。

データ型: single | double | int8 | int16 | int32 | uint8 | uint16 | uint32

sigma — ガウス分布の標準偏差

0.5 (既定値) | 正の数値 | 正の数値の 2 要素ベクトル

ガウス分布の標準偏差。正の数値または正の数値の 2 要素ベクトルとして指定します。スカラーを指定した場合、imgaussfilt は正方形ガウス カーネルを使用します。

データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

名前と値の引数

オプションの引数のペアを Name1=Value1,...,NameN=ValueN として指定します。ここで、Name は引数名で、Value は対応する値です。名前と値の引数は他の引数の後に指定しなければなりませんが、ペアの順序は重要ではありません。

例: B = imgaussfilt(A,FilterSize=3); は、サイズ 3 のフィルターを指定します。

R2021a より前では、コンマを使用して名前と値をそれぞれ区切り、Name を引用符で囲みます。

例: B = imgaussfilt(A,"FilterSize",3);

FilterSize — ガウス フィルターのサイズ

正の奇数の整数 | 正の奇数の整数の 2 要素ベクトル

ガウス フィルターのサイズ。正の奇数、または正の奇数の 2 要素ベクトルとして指定します。スカラーを指定した場合、imgaussfilt は正方形フィルターを使用します。既定のフィルター サイズは 2*ceil(2*sigma)+1 です。

データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Padding — イメージ パディング

"replicate" (既定値) | 数値スカラー | "circular" | "symmetric"

イメージ パディング。次の表のいずれかの値として指定します。

値	説明	例
数値スカラー X	配列の境界の外に位置する入力配列の値は、値 X に割り当てられます。	$$\left[\begin{array}{ccc}3& 1& 4\\ 1& 5& 9\\ 2& 6& 5\end{array}\right]\to \left[\begin{array}{ccccccc}2& 2& 2& 2& 2& 2& 2\\ 2& 2& 2& 2& 2& 2& 2\\ 2& 2& 3& 1& 4& 2& 2\\ 2& 2& 1& 5& 9& 2& 2\\ 2& 2& 2& 6& 5& 2& 2\\ 2& 2& 2& 2& 2& 2& 2\\ 2& 2& 2& 2& 2& 2& 2\end{array}\right]$$ は値 2 のパディングを示します。
"symmetric"	配列の境界の外に位置する入力配列値を計算するには、配列の境界をまたぐ配列の鏡像を使用します。	$$\left[\begin{array}{ccc}3& 1& 4\\ 1& 5& 9\\ 2& 6& 5\end{array}\right]\to \left[\begin{array}{ccccccc}5& 1& 1& 5& 9& 9& 5\\ 1& 3& 3& 1& 4& 4& 1\\ 1& 3& 3& 1& 4& 4& 1\\ 5& 1& 1& 5& 9& 9& 5\\ 6& 2& 2& 6& 5& 5& 6\\ 6& 2& 2& 6& 5& 5& 6\\ 5& 1& 1& 5& 9& 9& 5\end{array}\right]$$
"replicate"	配列の境界の外に位置する入力配列値は、最近傍の配列境界値と等しいと仮定します。	$$\left[\begin{array}{ccc}3& 1& 4\\ 1& 5& 9\\ 2& 6& 5\end{array}\right]\to \left[\begin{array}{ccccccc}3& 3& 3& 1& 4& 4& 4\\ 3& 3& 3& 1& 4& 4& 4\\ 3& 3& 3& 1& 4& 4& 4\\ 1& 1& 1& 5& 9& 9& 9\\ 2& 2& 2& 6& 5& 5& 5\\ 2& 2& 2& 6& 5& 5& 5\\ 2& 2& 2& 6& 5& 5& 5\end{array}\right]$$
"circular"	配列の境界の外に位置する入力配列値は、入力配列が周期的であると暗黙的に仮定します。	$$\left[\begin{array}{ccc}3& 1& 4\\ 1& 5& 9\\ 2& 6& 5\end{array}\right]\to \left[\begin{array}{ccccccc}5& 9& 1& 5& 9& 1& 5\\ 6& 5& 2& 6& 5& 2& 6\\ 1& 4& 3& 1& 4& 3& 1\\ 5& 9& 1& 5& 9& 1& 5\\ 6& 5& 2& 6& 5& 2& 6\\ 1& 4& 3& 1& 4& 3& 1\\ 5& 9& 1& 5& 9& 1& 5\end{array}\right]$$

データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | char | string

FilterDomain — フィルター処理を実行する領域

"auto" (既定値) | "spatial" | "frequency"

フィルター処理を実行する領域。以下のいずれかの値に指定します。

値	説明
"auto"	内部の経験則に基づいて空間領域または周波数領域で畳み込みを実行します。
"frequency"	周波数領域で畳み込みを実行します。
"spatial"	空間領域で畳み込みを実行します。

データ型: char | string

出力引数

B — フィルター処理されたイメージ

数値配列

フィルター処理されたイメージ。入力イメージ A と同じクラスとサイズの数値配列として返されます。

ヒント

• 値が Inf または NaN である要素がイメージ A に含まれている場合、imgaussfilt の周波数領域でのフィルター処理動作は定義されません。これは、名前と値の引数 FilterDomain に "frequency" を設定するか、"auto" を設定し、なおかつ imgaussfilt で周波数領域のフィルター処理を使用した場合に発生します。imfilter と同様の方法で出力での Inf と NaN の伝播を制限するために、名前と値の引数 FilterDomain に "spatial" を設定することを検討してください。

• 名前と値の引数 FilterDomain に "auto" を設定すると、imgaussfilt は内部の経験則を使用して、空間領域と周波数領域のいずれのフィルター処理が高速かを判定します。この経験則はマシンに依存し、各種構成によって異なる場合があります。最適なパフォーマンスを得られるように、"spatial" と "frequency" の両方のオプションを試し、使用するイメージとカーネル サイズに最適なフィルター処理領域を決定します。

• 名前と値の引数 Padding を指定しない場合、imgaussfilt は既定の設定で "replicate" パディングを使用します。これは imfilter で使用される既定の設定とは異なります。

拡張機能

C/C++ コード生成

MATLAB® Coder™ を使用して C および C++ コードを生成します。

使用上の注意および制限:

• imgaussfilt では C コードの生成がサポートされています (MATLAB^® Coder™ が必要)。汎用の MATLAB Host Computer ターゲット プラットフォームを選択した場合、プリコンパイルされたプラットフォーム固有の共有ライブラリを使用するコードが、imgaussfilt によって生成されます。共有ライブラリを使用するとパフォーマンスの最適化は維持されますが、コードを生成できるターゲット プラットフォームが限定されます。詳細については、Image Processing Toolbox でサポートされているコード生成のタイプを参照してください。

• imgaussfilt は、"frequency" として指定された名前と値の引数 FilterDomain をサポートしません。生成されたコードでは、フィルター処理が常に空間領域で行われます。

• コードを生成する際、すべての string および文字ベクトルの入力引数はコンパイル時の定数でなければなりません。

GPU コード生成

GPU Coder™ を使用して NVIDIA® GPU のための CUDA® コードを生成します。

使用上の注意および制限:

• imgaussfilt は、"frequency" として指定された名前と値の引数 FilterDomain をサポートしません。生成されたコードでは、フィルター処理が常に空間領域で行われます。

• コードを生成する際、すべての string および文字ベクトルの入力引数はコンパイル時の定数でなければなりません。

スレッドベースの環境

MATLAB® の backgroundPool を使用してバックグラウンドでコードを実行するか、Parallel Computing Toolbox™ の ThreadPool を使用してコードを高速化します。

この関数は、スレッドベースの環境を完全にサポートします。詳細については、スレッドベースの環境での MATLAB 関数の実行を参照してください。

GPU 配列

Parallel Computing Toolbox™ を使用してグラフィックス処理装置 (GPU) 上で実行することにより、コードを高速化します。

この関数は、GPU 配列を完全にサポートします。詳細については、GPU でのイメージ処理を参照してください。

バージョン履歴

R2015a で導入

R2022b: スレッドベース環境のサポート

imgaussfilt は、スレッドベースの環境をサポートするようになりました。

参考

imgaussfilt3 | imfilter | fspecial

トピック

• imfilter の境界パディング オプション