vision.Mean

(削除済み) 入力または入力シーケンスの平均値の検出

vision.Mean 関数は削除されました。代わりに、関数 mean と関数 movmean を使用して平均値を求めます。

説明

入力または入力シーケンスの平均値を検出します。

一連の点の追跡:

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

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

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

作成

構文

minObj = vision.Mean

minObj = vision.Mean(Name,Value)

説明

minObj = vision.Mean は、入力または入力シーケンスの最大値要素の値とインデックスを計算するオブジェクト minObj を返します。

minObj = vision.Mean(Name,Value) は、名前と値のペアを 1 つ以上使用してプロパティを設定します。各プロパティ名を引用符で囲みます。例: minObj = vision.Maximum('RunningMean',false)

プロパティ

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

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

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

RunningMean — 単一または複数の入力の計算

false (既定値) | true

単一または複数の入力を計算します。true または false として指定します。このプロパティを true に設定すると、オブジェクトは入力シーケンスで平均値を計算します。このプロパティを false に設定すると、オブジェクトは現在の入力で平均値を計算します。

ResetInputPort — ランニング平均のリセットを有効にする追加の入力

false (既定値) | true

ランニング平均のリセットを有効にする追加の入力。true または false として指定します。このプロパティを true に設定すると、リセット入力はランニング平均をリセットするように指定されなければなりません。このプロパティは、RunningMean プロパティを true に設定した場合にのみ適用されます。

ResetCondition — ランニング平均のリセットをトリガーする条件

'Non-zero' (既定値) | 'Rising edge' | 'Falling edge' | 'Either edge'

ランニング平均のリセットをトリガーする条件。'Rising edge'、'Falling edge'、'Either edge'、または 'Non-zero' として指定します。このプロパティは、ResetInputPort プロパティを true に設定した場合にのみ適用されます。

Dimension — 動作する対象の次元

'Column' (既定値) | {'All'} | 'Row' | 'Custom'

動作する対象の次元。{'All'}、'Row'、'Column'、または 'Custom' として指定します。このプロパティは、RunningMean プロパティを false に設定した場合にのみ適用されます。

CustomDimension — 計算する対象の数値次元

1 (既定値) | 数値スカラー

計算する対象の数値次元。数値スカラーとして指定します。このプロパティは、Dimension プロパティを 'Custom' に設定した場合にのみ適用されます。

ROIProcessing — 関心領域の処理の有効化

false (既定値) | true

関心領域の処理を有効にします。true または false として指定します。このプロパティは、Dimension プロパティを 'All' に設定し、かつ RunningMean プロパティを false に設定した場合に適用されます。

ROIForm — ROI のタイプ

'Rectangles' (既定値) | Lines' | 'Label matrix''Binary mask'

ROI のタイプ。'Rectangles'、Lines'、'Label matrix'、または 'Binary mask' として指定します。このプロパティは、ROIProcessing プロパティを true に設定した場合にのみ適用されます。

ROIPortion — ROI または周辺長の計算

'Entire ROI' (既定値) | 'ROI perimeter'

ROI または周辺長の計算。'Entire ROI' または 'ROI perimeter' として指定します。このプロパティは、ROIForm プロパティを 'Rectangles' に設定した場合にのみ適用されます。

ROIStatistics — 各 ROI の統計、またはすべての ROI に対する 1 つの統計の計算

'Individual statistics for each ROI' (既定値) | 'Single statistic for all ROIs'

各 ROI の統計、またはすべての ROI に対する 1 つの統計を計算します。'Individual statistics for each ROI' または 'Single statistic for all ROIs' として指定します。このプロパティは、'ROIForm' プロパティを 'Rectangles'、'Lines'、または 'Label matrix' に設定した場合にのみ適用されます。

ValidityOutputPort — ROI の任意の部分が入力イメージの外側にあるかどうかを示すフラグ

false (既定値) | true

ROI の任意の部分が入力イメージの外側にあるかどうかを示すフラグ。true または false として指定します。

これは、ROIForm プロパティを 'Lines' または 'Rectangles' に設定した場合に適用されます。

このプロパティを true に設定すると、指定されたラベルの番号の有効性が返されます。このプロパティは、ROIForm のプロパティが 'Label matrix' に設定されている場合に適用されます。

固定小数点プロパティ

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' に設定した場合にのみ適用されます。

使用法

構文

[value,index] = minObj(input)

index = minObj(input)

[___] = minObj(I,ROI)

[___,flag] = minObj(I,ROI)

[___] = minObj(I,label,labelNumbers)

[___,flag] = minObj(I,label,labelNumbers)

説明

[value,index] = minObj(input) は、入力の平均値とインデックスを返します。

index = minObj(input) は、IndexOutputPort プロパティを true に設定し、かつ ValueOutputPort プロパティを false に設定した場合に、平均値の 1 ベースのインデックスを返します。RunningMean プロパティは false に設定しなければなりません。

[___] = minObj(I,ROI) は、指定した関心領域内の入力イメージの平均値を返します。

[___,flag] = minObj(I,ROI) はさらに、指定した ROI がイメージの境界内かどうかを示すフラグを返します。

[___] = minObj(I,label,labelNumbers) は、labelNumbers ベクトルで指定したラベルの領域の入力イメージの平均値を返します。領域は、label 行列で定義およびラベル付けされます。

[___,flag] = minObj(I,label,labelNumbers) はさらに、入力ラベルの数が有効かどうかを示すフラグを返します。

入力引数

input — 入力データ

ベクトル | 行列 | 多次元配列

入力データ。ベクトル、行列、または多次元配列として指定します。

ROI — 関心領域

4 要素のベクトル

関心領域。4 要素のベクトル [x y width height] として指定します。このオプションは、ROIProcessing プロパティを true に設定し、かつ ROIForm プロパティを 'Lines'、'Rectangles'、または 'Binary Mask' に設定した場合に使用できます。

label — ラベル番号

行列

ラベル番号。行列として指定します。このオプションは、ROIProcessing プロパティを true に設定し、かつ ROIForm プロパティを 'Label matrix' に設定した場合に使用できます。

labelNumbers — ラベル番号

ベクトル

ラベル番号。ベクトルとして指定します。このオプションは、ROIProcessing プロパティを true に設定し、かつ ROIForm プロパティを 'Label matrix' に設定した場合に使用できます。

出力引数

value — 平均値

入力と同じ

平均値。入力と同じデータ型として返されます。

index — 平均値のインデックス

1 ベースのインデックス

平均値のインデックス。1 ベースのインデックスとして返されます。

flag — 有効なデータのフラグ

true | false

有効なデータのフラグ。true または false として返されます。

オブジェクト関数

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

release(obj)

すべての System object に共通

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

例

グレースケール イメージの平均値の判定

1. カラー イメージを読み取ります。

   img = imread('peppers.png');

2. イメージをグレースケールに変換します。

   img = im2single(im2gray(img));

3. 平均を求めます。

   hMean = vision.Mean;
   mean = hMean(img);

拡張機能

C/C++ コード生成

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

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

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

バージョン履歴

R2012a で導入

R2024b: vision.Mean 関数は削除済み

vision.Mean 関数は削除されました。代わりに、関数 mean と関数 movmean を使用して平均値を求めます。

R2024a: 関数 vision.Mean は削除予定

関数 vision.Mean は将来のリリースで削除される予定です。代わりに、関数 mean と関数 movmean を使用して平均値を求めます。

参考

mean | movmean