imregionalmin

局所的な最小値

構文

BW = imregionalmin(I)

BW = imregionalmin(I,conn)

説明

BW = imregionalmin(I) は、グレースケール イメージ I の中の局所的な最小値を識別するバイナリ イメージ BW を出力します。局所的な最小値は、同じ強度値を持つ連結要素のピクセルで、この強度値より大きい値を持つピクセルで囲まれています。

BW = imregionalmin(I,conn) で必要な連結性 conn を指定します。

例

シンプルなサンプル イメージの局所的な最小値の検出

いくつかの局所的な最小値をもつシンプルなサンプル配列を作成します。

A = 10*ones(10,10);
A(2:4,2:4) = 3;       
A(6:8,6:8) = 8

A = 10×10

    10    10    10    10    10    10    10    10    10    10
    10     3     3     3    10    10    10    10    10    10
    10     3     3     3    10    10    10    10    10    10
    10     3     3     3    10    10    10    10    10    10
    10    10    10    10    10    10    10    10    10    10
    10    10    10    10    10     8     8     8    10    10
    10    10    10    10    10     8     8     8    10    10
    10    10    10    10    10     8     8     8    10    10
    10    10    10    10    10    10    10    10    10    10
    10    10    10    10    10    10    10    10    10    10

局所的な最小値を計算します。関数は入力イメージと同じサイズのバイナリ イメージを出力します。この中で値 1 をもつピクセルは局所的な最小値を表しています。imregionalmin は他のすべてのピクセルを 0 に設定します。

regmin = imregionalmin(A)

regmin = 10×10 logical array

   0   0   0   0   0   0   0   0   0   0
   0   1   1   1   0   0   0   0   0   0
   0   1   1   1   0   0   0   0   0   0
   0   1   1   1   0   0   0   0   0   0
   0   0   0   0   0   0   0   0   0   0
   0   0   0   0   0   1   1   1   0   0
   0   0   0   0   0   1   1   1   0   0
   0   0   0   0   0   1   1   1   0   0
   0   0   0   0   0   0   0   0   0   0
   0   0   0   0   0   0   0   0   0   0

入力引数

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

数値配列

グレースケール イメージ。任意の次元の数値配列として指定します。

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

conn — ピクセルの連結性

4 | 8 | 6 | 18 | 26 | 0 と 1 から成る 3 x 3 x ... x 3 の行列

ピクセルの連結性。次の表のいずれかの値を指定します。既定の連結性は 2 次元イメージでは 8、3 次元イメージでは 26 です。

値	意味
2 次元連結性
4	ピクセルのエッジの部分が接触している場合、ピクセルは連結されます。ピクセルの近傍は水平方向または垂直方向に隣接するピクセルです。	現在のピクセルを灰色で示します。
8	ピクセルのエッジまたはコーナーが接触している場合、ピクセルは連結されます。ピクセルの近傍は水平方向、垂直方向または対角方向に隣接するピクセルです。	現在のピクセルを灰色で示します。
3 次元連結性
6	面が接触している場合、ピクセルは連結されます。ピクセルの近傍は次のように隣接するピクセルです。 次のいずれかの方向: 奥、手前、左、右、上および下	現在のピクセルを灰色で示します。
18	面またはエッジが接触している場合、ピクセルは連結されます。ピクセルの近傍は次のように隣接するピクセルです。 次のいずれかの方向: 奥、手前、左、右、上および下 右下または上の奥など、2 つの方向の組み合わせ	現在のピクセルは立方体の中心です。
26	面、エッジまたはコーナーが接触している場合、ピクセルは連結されます。ピクセルの近傍は次のように隣接するピクセルです。 次のいずれかの方向: 奥、手前、左、右、上および下 右下または上の奥など、2 つの方向の組み合わせ 右上の奥または左下の奥など、3 つの方向の組み合わせ	現在のピクセルは立方体の中心です。

高次元の場合、imregionalmin は既定値 conndef(ndims(I),"maximal") を使用します。

連結性は、0 と 1 から成る 3 × 3 × ... × 3 行列を指定し、任意の次元に対してより一般的に定義することもできます。1 の値を持つ要素は、conn の中心要素に対する近傍の位置を定義します。conn は、その中心要素に関して対称でなければなりません。詳細については、カスタム連結性の定義を参照してください。

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

出力引数

BW — 局所的な最小値の位置

logical 配列

局所的な最小値の位置。I と同じサイズの logical 配列として返されます。値 1 のピクセルは、局所的な最大値を示し、他のすべてのピクセルは値 0 で設定されます。

データ型: logical

拡張機能

C/C++ コード生成

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

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

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

• コードを生成する際、オプションの 2 番目の入力引数 conn はコンパイル時の定数でなければなりません。

スレッドベースの環境

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

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

GPU 配列

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

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

• 入力は 2 次元でなければなりません。サポートされる連結性は 2 次元 (4 および 8) のみです。

詳細については、GPU でのイメージ処理を参照してください。

バージョン履歴

R2006a より前に導入

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

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

参考

conndef | imextendedmin | imhmin | imimposemin | imreconstruct | imregionalmax