Operator Histogram

Operator Library: Accumulator

このオペレーターは、入力画像(I)から強度ヒストグラムを計算し、出力(O)に出力します。AutoSync パラメーターのオプションに応じて、ヒストグラムはライン単位またはフレーム単位で計算されます。出力結果は視覚化されたものではなく、ヒストグラム値のリストです。

  • AutoSync = EoF は、フレーム全体に対して高さ 1 のヒストグラム画像を生成します。
  • AutoSync = EoL は、入力画像の高さを持つヒストグラム画像を生成します。つまり、入力画像の各ラインに対して個別にヒストグラムが計算されます。

ヒストグラム自体は 2^(InputBitWidth) 個の要素で構成されます。各要素は、各階調値のピクセル数です。ヒストグラム出力の最初のピクセルは、階調値がゼロのピクセル数です。

Histogram オペレーターは、中間ヒストグラム結果を格納するために内部 Memory を使用します。オペレーターがビジー状態の間は、新しいデータの到着を防ぐために入力がブロックされます。次のケースでは入力がブロックされます:

  • 入力フレームまたは入力ラインの処理: 入力フレームまたは入力ラインが処理されている間、オペレーターは中間ヒストグラム結果を内部 Memory に格納します。入力フレーム(AutoSync = EoF)または入力ライン(AutoSync = EoL)が完了すると、結果のヒストグラムデータを取得するために内部 Memory が読み出されます。読み出しフェーズの間は、入力がブロックされます。その結果、小さな入力画像とラインベースのヒストグラム出力(AutoSync = EoL)を使用すると、入力帯域幅が大幅に減少します。

  • システム起動後またはリセット後の初期化: システムの起動時またはリセット後、内部 Memory はゼロで初期化されます。この初期化プロセスの間、オペレーターはビジー状態となり、新しいデータが受信されないように入力がブロックされます。

I/O Property

Property 値
オペレータータイプ M
Input Link I、Image Input
Output Link O、Data Output

サポートされているリンクフォーマット

Link Parameter Input Link I Output Link O
Bit Width [1, 16] auto1
Arithmetic unsigned as I
Parallelism any as I
Kernel Columns 1 as I
Kernel Rows 1 as I
Img Protocol VALT_IMAGE2D as I
Color Format VAF_GRAY as I
Color Flavor FL_NONE as I
Max. Img Width any auto2
Max. Img Height any auto3

1

出力 Bit Width は、最大画像寸法のリンク Property と AutoSync パラメーターの設定によって異なります。

AutoSync = EoF の場合、出力 Bit Width は次のようになります

AutoSync = EoL の場合、出力 Bit Width は次のようになります

出力の Bit Width は 64 Bit を超えてはなりません。

2

出力画像幅は入力 Bit Width によって決定されます。入力画像の可能な各ピクセル値は、出力画像のピクセルによって表されます。

3

AutoSync = EoF パラメーターの場合、出力画像の高さは 1 です。AutoSync = EoL パラメーターの場合、出力画像の高さは入力画像の高さと等しくなります。

パラメーター

AutoSync
タイプ static パラメータ
Default EoL
範囲 {EoL, EoF}

このパラメーターは、ラインごとにヒストグラムを出力するか(EoL 設定)、フレームごとに出力するか(EoF 設定)を選択します。出力 Bit Width に対するパラメーターの影響に注意してください。出力 Bit Width は 64 Bit を超えてはなりません。

使用例

Histogram オペレーターの使用方法については、以下の例をご覧ください: