imboxfilt3

3 次元イメージの 3 次元ボックスフィルター処理

ページ内をすべて折りたたむ

構文

B = imboxfilt3 (A)

B = imboxfilt3(A,filterSize)

B = imboxfilt3(___,Name,Value)

説明

例

B= imboxfilt3(A)はサイズが 3 x 3 x 3 の 3 次元ボックスフィルターを使用して 3 次元イメージAをフィルター処理します。

B= imboxfilt3(A,filterSize)は、サイズがfilterSizeの 3 次元ボックスフィルターを使用して 3 次元イメージAをフィルター処理します。

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

例

すべて折りたたむ

MRI ボリュームの平均値フィルターの計算

ライブスクリプトを開く

3 次元イメージデータをワークスペースに読み込みます。

volData = load('mri'); vol = squeeze(volData.D);

3 次元ボックスフィルターを使用してイメージをフィルター処理します。

localMean = imboxfilt3(vol,[5 5 3]);

入力引数

すべて折りたたむ

`A`—フィルター処理されるイメージ
3 次元数値配列

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

AにInfsまたはNaNsが含まれている場合、imboxfilt3の動作は定義されません。これは積分イメージベースのフィルター処理を使用する場合に発生する可能性があります。出力でのInfsとNaNsの伝播を制限するために、代わりにimfilterを使用することを検討してください。

`filterSize`—ボックスフィルターのサイズ
`3`(既定値) |正の奇数の整数|正の奇数の整数の 3 要素ベクトル

ボックスフィルターのサイズ。正の奇数の整数または正の奇数の整数の 3 要素ベクトルとして指定します。filterSizeがスカラーの場合、ボックスフィルターは立方体です。

名前と値の引数

例:B = imboxfilt3(A,5,'padding','circular');

オプションの引数Name,Valueのコンマ区切りペアを指定します。Nameは引数名で、Valueは対応する値です。Nameは引用符で囲まなければなりません。Name1,Value1,...,NameN,ValueNのように、複数の名前と値のペアの引数を、任意の順番で指定できます。

`Padding`—パディングパターン
`'replicate'`(既定値) |`'circular'`|`'symmetric'`|数値スカラー

パディングパターン。以下のいずれかの値または数値スカラーとして指定します。スカラー値を指定した場合、イメージの境界の外に位置する入力イメージのピクセルは、暗黙的にスカラー値をもつと仮定されます。

値	説明
`'circular'`	イメージの境界の外に位置する入力イメージの値は、入力イメージが周期的であると暗黙的に仮定して計算されます。
`'replicate'`	イメージの境界の外に位置する入力イメージの値は、最近傍のイメージ境界値と等しいと仮定します。
`'symmetric'`	イメージの境界の外に位置する入力イメージの値を計算するには、配列の境界をまたぐ配列の鏡像を使用します。

`NormalizationFactor`—ボックスフィルターに適用される正規化係数
スカラーの場合は`1/filterSize.^3`、ベクトルの場合は`1/prod(filterSize)`(既定値) |数値スカラー

ボックスフィルターに適用される正規化係数。数値スカラーとして指定します。

既定の設定の'NormalizationFactor'には平均値フィルターの効果があります。出力イメージのピクセルは、イメージの局所的な平均になります。局所領域の和を求めるには、'NormalizationFactor'を1に設定します。このような状況でオーバーフローを回避するために入力イメージをdoubleクラスに変換して倍精度イメージを使用することを検討してください。

例:'NormalizationFactor',1

出力引数

すべて折りたたむ

`B`— フィルター処理されたイメージ
3 次元数値配列

フィルター処理されたイメージ。3 次元数値配列として返されます。

アルゴリズム

imboxfiltは畳み込みに基づいたフィルター処理または積分イメージフィルター処理を使用してフィルター処理を実行します。どちらのフィルター処理方法を使用するかは、内部の経験則を用いて決定されます。

バージョン履歴

R2015b で導入

参考

imboxfilt|imfilter|integralBoxFilter3

imboxfilt3

構文

説明

例

MRI ボリュームの平均値フィルターの計算

入力引数

A—フィルター処理されるイメージ3 次元数値配列

filterSize—ボックス フィルターのサイズ3(既定値) |正の奇数の整数|正の奇数の整数の 3 要素ベクトル

名前と値の引数

Padding—パディング パターン'replicate'(既定値) |'circular'|'symmetric'|数値スカラー

NormalizationFactor—ボックス フィルターに適用される正規化係数スカラーの場合は1/filterSize.^3、ベクトルの場合は1/prod(filterSize)(既定値) |数値スカラー

出力引数

B— フィルター処理されたイメージ3 次元数値配列

アルゴリズム

バージョン履歴

参考

`A`—フィルター処理されるイメージ
3 次元数値配列

`filterSize`—ボックスフィルターのサイズ
`3`(既定値) |正の奇数の整数|正の奇数の整数の 3 要素ベクトル

`Padding`—パディングパターン
`'replicate'`(既定値) |`'circular'`|`'symmetric'`|数値スカラー

`NormalizationFactor`—ボックスフィルターに適用される正規化係数
スカラーの場合は`1/filterSize.^3`、ベクトルの場合は`1/prod(filterSize)`(既定値) |数値スカラー

`B`— フィルター処理されたイメージ
3 次元数値配列