vision.BlobAnalysis

連結された領域のプロパティ

説明

バイナリ イメージ内の連結された領域の統計量を計算する

一連の点の追跡:

1. vision.BlobAnalysis オブジェクトを作成し、そのプロパティを設定します。

2. 関数と同様に、引数を指定してオブジェクトを呼び出します。

System object の機能の詳細については、System object とはを参照してください。

作成

構文

Hblob = vision.BlobAnalysis

Hblob = vision.BlobAnalysis(Name,Value)

説明

Hblob = vision.BlobAnalysis は、バイナリ イメージ内の連結された領域の統計量の計算に使用されるブロブ解析オブジェクト H を返します。

Hblob = vision.BlobAnalysis(Name,Value) は、名前と値のペアを 1 つ以上使用してプロパティを設定します。各プロパティ名を引用符で囲みます。たとえば、Hblob = vision.BlobAnalysis('AreaOutputPort',true) です。

プロパティ

特に指定がない限り、プロパティは "調整不可能" です。つまり、オブジェクトの呼び出し後に値を変更することはできません。オブジェクトは呼び出すとロックされ、ロックを解除するには関数 release を使用します。

プロパティが "調整可能" の場合、その値をいつでも変更できます。

プロパティ値の変更の詳細については、System object を使用した MATLAB でのシステム設計を参照してください。

AreaOutputPort — ブロブ面積を返す

true (既定値) | false

ブロブ面積を返します。true または false として指定します。

CentroidOutputPort — ブロブの重心の座標を返す

true (既定値) | false

ブロブの重心の座標を返します。true または false として指定します。

BoundingBoxOutputPort — 境界ボックスの座標を返す

true (既定値) | false

境界ボックスの座標を返します。true または false として指定します。

MajorAxisLengthOutputPort — 値が楕円の長軸の長さを表すベクトルを返す

false (既定値) | true

値が楕円の長軸の長さを表すベクトルを返します。true または false として指定します。このプロパティを true に設定すると、値が楕円の長軸の長さを表すベクトルが出力されます。この楕円は、ラベル付けされた領域と同じ正規化された 2 次中心モーメントをもちます。このプロパティは、OutputDataType プロパティを double または single に設定した場合に適用されます。

MinorAxisLengthOutputPort — 値が楕円の短軸の長さを表すベクトルを返す

false (既定値) | true

値が楕円の短軸の長さを表すベクトルを返します。true または false として指定します。このプロパティを true に設定すると、値が楕円の短軸の長さを表すベクトルが出力されます。この楕円は、ラベル化されたと同じ正規化された 2 次中心モーメントをもちます。このプロパティは OutputDataType プロパティが double または single である場合に使用できます。

OrientationOutputPort — 値が楕円の長軸と x 軸の角度を表すベクトルを返す

false (既定値) | true

値が楕円の長軸と x 軸の角度を表すベクトルを返します。true または false として指定します。このプロパティを true に設定すると、値が楕円の長軸と x 軸の間の角度を表すベクトルが出力されます。このプロパティは、OutputDataType プロパティを double または single に設定した場合に適用されます。

EccentricityOutputPort — 値が楕円の離心率を表すベクトルを返す

false (既定値) | true

値が楕円の離心率を表すベクトルを返します。true または false として指定します。このプロパティを true に設定すると、値が楕円の離心率を表すベクトルが出力されます。この楕円は、領域と同じ 2 次モーメントをもちます。このプロパティは、OutputDataType プロパティを double または single に設定した場合に適用されます。

EquivalentDiameterSquaredOutputPort — 値が等価直径の二乗を表すベクトルを返す

false (既定値) | true

値が等価直径の二乗を表すベクトルを返します。true または false として指定します。このプロパティを true に設定すると、値が等価直径の二乗を表すベクトルが出力されます。

ExtentOutputPort — 値がブロブの面積を境界ボックスの面積で除算した結果を表すベクトルを返すプロパティ

false (既定値) | true

値がブロブの面積を境界ボックスの面積で除算した結果を表すベクトルを返します。true または false として指定します。

PerimeterOutputPort — 値がブロブの周囲長の推定値を表すベクトルを返す

false (既定値) | true

値がブロブの周囲長の推定値を表すベクトルを返します。true または false として指定します。

OutputDataType — 統計値の出力データ型

double (既定値) | single | Fixed point

統計値の出力データ型。double、single、または Fixed point として指定します。面積と境界ボックスの出力のデータ型は、常に int32 になります。このプロパティを Fixed point に設定すると、Major axis length、Minor axis length、Orientation および Eccentricity は適用されません。

Connectivity — 連結ピクセル

8 (既定値) | 4

連結ピクセル。4 または 8 として指定します。

LabelMatrixOutputPort — 各入力イメージのラベル付けされた領域の最大数

50 (既定値) | 正のスカラー整数。

各入力イメージのラベル付けされた領域の最大数。正のスカラー整数として指定します。オブジェクトが出力するブロブの最大数は、このプロパティの値と入力イメージのサイズの両方に依存します。入力イメージのサイズによってオブジェクトが出力するブロブの数が制限されることがあります。

MinimumBlobArea — ピクセル単位の最小ブロブ面積

0 (既定値) | 正のスカラー整数。

ピクセル単位の最小ブロブ面積。正のスカラー整数として指定します。

調整可能: Yes

MaximumBlobArea — ピクセル単位の最大ブロブ面積

intmax('uint32') (既定値) | 整数

ピクセル単位の最大ブロブ面積。整数として指定します。

調整可能: Yes

ExcludeBorderBlobs — 少なくとも 1 つのイメージ境界ピクセルを含むブロブの除外

false (既定値) | true

少なくとも 1 つのイメージ境界ピクセルを含むブロブを除外します。true または false として指定します。

MaximumCount — 各入力イメージのラベル付けされた領域の最大数

50 (既定値) | 正のスカラー整数

各入力イメージのラベル付けされた領域の最大数。正のスカラー整数として指定します。オブジェクトが出力するブロブの最大数は、このプロパティの値と入力イメージのサイズの両方に依存します。入力イメージのサイズによってオブジェクトが出力するブロブの数が制限されることがあります。

固定小数点プロパティ

RoundingMethod — 固定小数点演算の丸め手法

'Floor' (既定値) | 'Ceiling' | 'Convergent' | 'Nearest''Round' | 'Simplest''Zero'

固定小数点演算の丸め手法。'Floor'、'Ceiling'、'Convergent'、'Nearest'、'Round'、'Simplest'、または 'Zero' として指定します。

OverflowAction — 整数入力が範囲外の場合に実行するアクション

'Wrap' (既定値) | 'Saturate'

整数入力が範囲外の場合に実行するアクション。'Wrap' または 'Saturate' として指定します。

ProductDataType — 積のデータ型

'Same as input' (既定値) | 'Custom'

積のデータ型。'Same as input' または 'Custom' として指定します。

CustomProductDataType — 乗算の語長と小数部の長さ

numerictype(true,32,30) (既定値) | スケーリングされた numerictype オブジェクト

乗算の語長と小数部の長さ。スケーリングされた numerictype (Fixed-Point Designer) オブジェクトとして指定します。このプロパティは、AccumulatorDataType プロパティを 'Custom' に設定した場合にのみ適用されます。

AccumulatorDataType — アキュムレータのデータ型

'Same as product' (既定値) | 'Same as input' | 'Custom'

アキュムレータのデータ型。'Same as product'、'Same as input'、または 'Custom' として指定します。

CustomAccumulatorDataType — アキュムレータの語長と小数部の長さ

numerictype(true,32,30) (既定値) | スケーリングされた numerictype オブジェクト

アキュムレータの語長と小数部の長さ。スケーリングされた numerictype (Fixed-Point Designer) オブジェクトとして指定します。このプロパティは、AccumulatorDataType プロパティを 'Custom' に設定した場合にのみ適用されます。

使用法

構文

[area,centroid,bbox] = Hblob(bw)

[___,majoraxis] = Hblob(bw)

[___,minoraxis] = Hblob(bw)

[bw___,orientation] = Hblob(bw)

[___,eccentricity] = Hblob(bw)

[___,EQDIASQ] = Hblob(bw)

[___,EXTENT] = Hblob(bw)

[___,perimeter] = Hblob(bw)

[___,label] = Hblob(bw)

説明

[area,centroid,bbox] = Hblob(bw) は、AreaOutputPort、CentroidOutputPort、および BoundingBoxOutputPort プロパティが true に設定されている場合に、ブロブの面積、重心、および境界ボックスを返します。既定で true に設定されるのは、これらのプロパティだけです。追加プロパティを true に設定すると、area、centroid および bbox の出力に従って対応する出力が返されます。

[___,majoraxis] = Hblob(bw) は、MajorAxisLengthOutputPort プロパティが true に設定されている場合に、入力バイナリ イメージ bw で見つかったブロブの長軸の長さ majoraxis を計算します。

[___,minoraxis] = Hblob(bw) は、MinorAxisLengthOutputPort プロパティが true に設定されている場合に、入力バイナリ イメージ BW で見つかったブロブの短軸の長さ minoraxis を計算します。

[bw___,orientation] = Hblob(bw) は、OrientationOutputPort プロパティが true に設定されている場合に、入力バイナリ イメージ bw で見つかったブロブの orientation を計算します。

[___,eccentricity] = Hblob(bw) は、EccentricityOutputPort プロパティが true に設定されている場合に、入力バイナリ イメージ bw で見つかったブロブの eccentricity を計算します。

[___,EQDIASQ] = Hblob(bw) は、EquivalentDiameterSquaredOutputPort プロパティが true に設定されている場合に、入力バイナリ イメージ bw で見つかったブロブの相当直径の 2 乗 EQDIASQ を計算します。

[___,EXTENT] = Hblob(bw) は、ExtentOutputPort プロパティが true に設定されている場合に、入力バイナリ イメージ bw で見つかったブロブの EXTENT を計算します。

[___,perimeter] = Hblob(bw) は、PerimeterOutputPort プロパティが true に設定されている場合に、入力バイナリ イメージ bw で見つかったブロブの perimeter を計算します。

[___,label] = Hblob(bw) は、LabelMatrixOutputPort プロパティが true に設定されている場合に、入力バイナリ イメージ bw で見つかったブロブのラベル行列 label を返します。

入力引数

bw — バイナリ イメージ

ベクトル | 行列

バイナリ イメージ。ベクトルまたは行列として指定します。

出力引数

area — ラベル付けされた領域のピクセル数

ベクトル

ラベル付けされた領域のピクセル数。ベクトルとして指定します。

centroid — 重心座標

M 行 2 列の行列。

重心座標。M 行 2 列の行列として指定します。M はブロブ数です。

bbox — 境界ボックス座標

M 行 4 列の行列

[x y width height] の形式の M 行 4 列の行列。ここで、M はブロブ数、[x y] は境界ボックスの左上隅を表します。

majoraxis — 楕円の長軸の長さ

ベクトル

楕円の長軸の長さ。ベクトルとして指定します。

minoraxis — 楕円の短軸の長さ

ベクトル

楕円の短軸の長さ。ベクトルとして指定します。

orientation — 楕円の長軸と x 軸の間の角度

ベクトル

楕円の長軸と x 軸の間の角度。ベクトルとして指定します。

eccentricity — 楕円の離心率

ベクトル

楕円の離心率。ベクトルとして指定します。

EQDIASQ — 相当直径の 2 乗

ベクトル

相当直径の 2 乗。ベクトルとして指定します。

extent — 面積と境界ボックスの間の比率

ベクトル

面積と境界ボックスの間の比率。ベクトルとして指定します。ベクトルには、ブロブの面積をその境界ボックスの面積で除算した結果が含まれます。

perimeter — 周囲長の推定

ベクトル

周囲長の推定。ベクトルとして指定します。ベクトルには、各ブロブの周囲長 (ピクセル単位) の推定が含まれます。

label — ラベル行列

行列

ラベル行列。行列として指定します。

オブジェクト関数

オブジェクト関数を使用するには、System object™ を最初の入力引数として指定します。たとえば、obj という名前の System object のシステム リソースを解放するには、次の構文を使用します。

release(obj)

すべての System object に共通

step	System object のアルゴリズムの実行
release	リソースを解放し、System object のプロパティ値と入力特性の変更を可能にします。
reset	System object の内部状態のリセット

例

ブロブの重心を求める

ブロブ解析オブジェクトを作成します。

hBlob = vision.BlobAnalysis('AreaOutputPort',false,'BoundingBoxOutputPort',false);

ブロブを作成します。

img = logical([0 0 0 0 0 0; ...
 		0 1 1 1 1 0; ...
 		0 1 1 1 1 0; ...
 		0 1 1 1 1 0; ...
 		0 0 0 0 0 0]);

重心の座標を求めます。

centroid = hBlob(img);

拡張機能

C/C++ コード生成

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

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

• MATLAB コード生成における System object (MATLAB Coder)を参照してください。

バージョン履歴

R2012a で導入

参考

graythresh | multithresh

トピック

• 細胞のカウント