roifilt2

グレースケール イメージの関心領域 (ROI) のフィルター

構文

J = roifilt2(h,I,BW)

J = roifilt2(I,BW,fun)

説明

J = roifilt2(h,I,BW) は、2 次元線形フィルター h を使用して 2 次元グレースケール イメージ I 内の関心領域 (ROI) をフィルター処理します。バイナリ マスク BW は、I 内の ROI を定義します。roifilt2 は、BW に 1 が格納されている場所のピクセルについてはフィルター処理された値、加えて BW に 0 が格納されている場所のピクセルについてはフィルター処理されていない値で構成されるイメージを返します。この種のフィルター処理を "マスクしたフィルター処理" と言います。

J = roifilt2(I,BW,fun) は、関数 fun を使用して I の ROI のデータを処理します。

例

多角形マスクを使用したイメージのフィルター処理

イメージをワークスペースに読み取ります。

I = imread("eight.tif");

マスクの多角形の頂点を定義します。

c = [222 272 300 270 221 194];
r = [21 21 75 121 121 75];

バイナリ マスク イメージを作成します。

BW = roipoly(I,c,r);

マスク BW で指定されたイメージ I の領域をフィルター処理します。

H = fspecial("unsharp");
J = roifilt2(H,I,BW);

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

imshow(I)

imshow(J)

入力引数

h — 線形フィルター

2 次元数値行列

線形フィルター。2 次元数値行列として指定します。

データ型: double

I — グレースケール イメージ

2 次元数値行列

グレースケール イメージ。2 次元数値行列として指定します。

• フィルター h を指定する場合、I は以下にリストされたいずれかのデータ型を指定できます。

• 関数ハンドル fun を指定する場合、I は fun でサポートされる任意のデータ型です。

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

BW — マスク

2 次元 logical 行列 | 2 次元数値行列

マスク。I と同じサイズの 2 次元 logical 行列または 2 次元数値行列として指定します。数値入力の場合、非ゼロのピクセルは 1 (true) であると見なされます。

fun — 関数ハンドル

ハンドル

関数ハンドル。ハンドルとして指定します。関数ハンドルの詳細については、関数ハンドルの作成を参照してください。

出力引数

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

2 次元行列

フィルター処理されたイメージ。2 次元行列として返されます。

• フィルター h を指定すると、J は、入力イメージ I と同じデータ型になります。

• 関数ハンドル fun を指定した場合は、J のデータ型は fun で決定されます。

アルゴリズム

フィルター h を指定すると、roifilt2 は imfilter を呼び出してフィルターを実装します。roifilt2 関数は、元のイメージがあったとおりの範囲にデータを出力する演算に適しています。なぜなら、出力イメージはマスクされていない領域に由来するそのデータの一部を、入力イメージから直接利用するからです。一部のフィルタリング演算では、値が通常のイメージ データの範囲 (double クラスで [0, 1]、uint8 クラスで [0, 255]、uint16 クラスで [0, 65535]) を超えることがあります。

拡張機能

C/C++ コード生成

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

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

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

• 関数 coder を使用し、fun を引数としてコードを生成する場合は、string 定数または文字ベクトルとして fun を指定します。たとえば、関数 adaptthresh を使用する場合、fun を string "adaptthresh" として指定し、関数 coder.Constant を使用してこの string を定数に変換します。

  codegen roifilt2 -args {I,BW,coder.Constant("adaptthresh")}

  ラッパー関数のコードを生成する場合、fun にはラッパー関数内の関数ハンドルを指定できます。たとえば、次のコマンドは、myFunction という名前のラッパー関数のコードを生成します。

  codegen myFunction -args {I,BW,coder.Constant("adaptthresh")}

  以下は、関数 roifilt2 への呼び出しを含むラッパー関数 myFunction の定義の例です。このラッパー関数では、str2func 関数を使用して fun が string 定数から関数ハンドルに変換されています。

  function out = myFunction(I,BW,fun) %#codegen
        fun1 = str2func(fun); % This will become fun1 = @adaptthresh
        out = roifilt2(I,BW,fun1);
  end

GPU コード生成

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

使用上の注意および制限については、「C/C++ コード生成」セクションを参照してください。GPU コード生成にも同様の、使用上の注意および制限が適用されます。

バージョン履歴

R2006a より前に導入

R2023b: C コード生成のサポート

roifilt2 は、C コードの生成をサポートするようになりました (MATLAB Coder が必要)。

参考

imfilter | filter2 | roipoly

トピック

• イメージの関心領域へのカスタム フィルターの適用
• イメージ内の関心領域のシャープ化