オペレーター ImageStatistics

Operator Library: Debugging

Operator ImageStatistics は、画像データに触れることなく、フレームシーケンス全体のフレーム Property を測定します。

Operator ImageStatistics は画像シーケンスを解析します。 個々の画像を解析するには、Operator ImageAnalyzer を使用してください。

この operator により、フレーム間の偏差(幅、高さ、サイズ、ラインギャップなど)を解析できます。 また、この operator はラインレートおよびフレームレートに関する測定値も提供します。

さらに、Operator ImageStatistics は、パイプライン容量の使用状況に関するデータ(有効割合、アイドル割合、ブロック時間の割合(パーセント))を提供します。

内部 Counter がオーバーフローすると、 OverflowMask パラメータに対応するオーバーフロー bit がセットされ、Counter が停止します。

[重要] ランタイムテスト

この operator は、ランタイム時にデザインをテストおよび解析するように設計されています。 operator をデバッグに使用する前に、デザインをビルド(合成)し、ターゲットハードウェアにロードして、実際の画像処理を開始する必要があります。

この operator は、VisualApplets 内でのデザインシミュレーションを目的としたものではありません。

I/O Property

Property 値
オペレータータイプ O
Input Link I、画像データ入力
Output Link O、画像データ出力

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

Link Parameter Input Link I Output Link O
Bit Width [1, 64] as I
Arithmetic {unsigned, signed} as I
Parallelism any as I
Kernel Columns any as I
Kernel Rows any as I
Img Protocol {VALT_IMAGE2D, VALT_LINE1D} as I
Color Format any as I
Color Flavor any as I
Max. Img Width any as I
Max. Img Height any as I

パラメーター

ClearMode
タイプ 動的書き込みパラメータ
Default ClearWithProcessStart
範囲 {NoClearing, ClearWithProcessStart, ClearWithProcessReset, SendClearPulse}

このパラメータは、すべての read パラメータのリセット動作を定義します。

NoClearing: すべての read パラメータの値が保持されます。 ProcessEnable および ProcessReset はこれらの値に影響を与えません。

ClearWithProcessStart: read パラメータの値は、ProcessEnable の立ち上がりエッジでのみクリアされます。

ClearWithProcessReset: read パラメータの値は、ProcessReset の立ち上がりエッジでのみクリアされます。

SendClearPulse: すべての read パラメータの値をオンデマンドでクリアします。

MeasurementPeriod
タイプ 動的リードパラメータ
Default 1000
範囲 [1, 65535]

レートおよびデューティ比の測定にかかる時間(ミリ秒)。

FrameCountWidth
タイプ static write parameter
Default 24
範囲 [4, 63]

フレーム Counter(パラメータ FrameCount)の Bit Width を設定します。

GapCountWidth
タイプ static write parameter
Default 20
範囲 [4, 63]

ラインギャップ Counter(MinLineGap、MaxLineGap、MeanLineGap、MinLinePeriod、MaxLinePeriod、MeanLinePeriod)の Bit Width を設定します。

FrameCount
タイプ 動的リードパラメータ
Default 0
範囲 [0, (2^FrameCountWidth) -1]

EndOfFrameで終了したすべての画像をカウントします。IMAGE-2Dモードでのみ使用可能です。

FramePixelCount
タイプ 動的リードパラメータ
Default 0
範囲 [0, (2^ (ImageWidthBitwidth+ImageHeightBitwidth+4))-1]

最後に完了したフレームのサイズ(ピクセル単位)。

MinWidth
タイプ 動的リードパラメータ
Default 0
範囲 [0, (2^(ImageWidthBitwidth+4))-1]

これまでに検査されたすべてのフレームで検出された最小のライン幅(ピクセル単位)。

MaxWidth
タイプ 動的リードパラメータ
Default 0
範囲 [0, (2^(ImageWidthBitwidth+4))-1]

これまでに検査されたすべてのフレームで検出された最大のライン幅(ピクセル単位)。

MinHeight
タイプ 動的リードパラメータ
Default 0
範囲 [0, (2^(ImageHeightBitwidth+4))-1]

これまでに検査されたすべてのフレームで検出された最小の画像高さ(ピクセル単位)。

MaxHeight
タイプ 動的リードパラメータ
Default 0
範囲 [0, (2^(ImageHeightBitwidth+4))-1]

これまでに検査されたすべてのフレームで検出された最大の画像高さ(ピクセル単位)。

MinPixelCount
タイプ 動的リードパラメータ
Default 0
範囲 [0, (2^(ImageWidthBitwidth+ImageHeightBitwidth+4))-1]

これまでに検査されたすべてのフレームの中での最小フレームのサイズ(ピクセル単位)。

MaxPixelCount
タイプ 動的リードパラメータ
Default 0
範囲 [0, (2^(ImageWidthBitwidth+ImageHeightBitwidth+4))-1]

これまでに検査されたすべてのフレームの中での最大フレームのサイズ(ピクセル単位)。

MinLineGap
タイプ 動的リードパラメータ
Default 0
範囲 [0, (2^GapCountWidth)-1]

これまでに検査されたすべてのフレームで発生した最小のラインギャップ。 2D画像の最後のラインと次の画像の最初のラインの間のフレームギャップは含みません。

MaxLineGap
タイプ 動的リードパラメータ
Default 0
範囲 [0, (2^GapCountWidth)-1]

これまでに検査されたすべてのフレームで発生した最大のラインギャップ。 2D画像の最後のラインと次の画像の最初のラインの間のフレームギャップは含みません。

MinLinePeriod
タイプ 動的リードパラメータ
Default 0
範囲 [0, (2^GapCountWidth)-1]

最小ライン周期に達しました。 ライン周期とは、2つのライン開始間のクロックサイクル数です。 したがって、ライン周期には、ライン幅、単一のEndOfLineパルス、およびラインギャップが含まれます。 2D画像の最終ラインと次の画像の先頭ラインの間のフレームギャップは含まれません。

MaxLinePeriod
タイプ 動的リードパラメータ
Default 0
範囲 [0, (2^GapCountWidth)-1]

最大ライン周期に達しました。 ライン周期とは、2つのライン開始間のクロックサイクル数です。 したがって、ライン周期には、ライン幅、単一のEndOfLineパルス、およびラインギャップが含まれます。 2D画像の最終ラインと次の画像の先頭ラインの間のフレームギャップは含まれません。

MeanWidth
タイプ 動的リードパラメータ
Default 0
範囲 [0, (2^(ImageWidthBitwidth+4))-1]

設定されたMeasurementPeriod中の平均ライン幅(ピクセル単位)。

MeanLinePeriod
タイプ 動的リードパラメータ
Default 0
範囲 [0, (2^GapCountWidth)-1]

設定されたMeasurementPeriod中の平均ライン周期。ライン周期とは、2つのライン開始間のクロックサイクル数です。 したがって、ライン周期には、ライン幅、単一のEndOfLineパルス、およびラインギャップが含まれます。 2D画像の最終ラインと次の画像の先頭ラインの間のフレームギャップは含まれません。

MeanLineGap
タイプ 動的リードパラメータ
Default 0
範囲 [0, (2^GapCountWidth)-1]

設定されたMeasurementPeriod中の平均ラインギャップ(2つのライン開始間の平均クロックサイクル数)。

2D画像の最終ラインと次の画像の先頭ラインの間のフレームギャップは含まれません。

MeanLineDutyCycle
タイプ 動的リードパラメータ
Default 0
範囲 [0.0, 100.0]

設定されたMeasurementPeriod中の平均ラインデューティサイクル。 MeanWidthをMeanLinePeriodで割ったものとして定義されます。

LineRate
タイプ 動的リードパラメータ
Default 0
範囲

ヘルツ単位のラインレート。

FrameRate
タイプ 動的リードパラメータ
Default 0
範囲

ヘルツ単位のフレームレート。

BlockedFraction
タイプ 動的リードパラメータ
Default 0
範囲 [0.0, 100.0]

ブロックされたサイクルの割合。

IdleFraction
タイプ 動的リードパラメータ
Default 0
範囲 [0.0, 100.0]

アイドルサイクルの割合。

ValidFraction
タイプ 動的リードパラメータ
Default 0
範囲 [0.0, 100.0]

データを運ぶ有効なサイクルの割合。

MaxWidthErrorCount
タイプ 動的リードパラメータ
Default 0
範囲 [0, (2^(ImageWidthBitwidth+4))-1]

ライン幅が入力リンクで定義された最大ライン幅よりも大きい場合にカウントアップします。

MaxHeightErrorCount
タイプ 動的リードパラメータ
Default 0
範囲 [0, (2^( ImageHeightBitwidth+4))-1]

入力リンクで定義された最大画像高さを超える画像高さの場合にCounterがアップします。

OverflowMask
タイプ 動的リードパラメータ
Default 0
範囲 [0, 4095]

ビットエンコードされたオーバーフローシグナリング。ビットがセットされている場合、以下のCounterでオーバーフローが発生していることを示します。

[0] = FrameCount

[1] = PixelCount

[2] = xPos

[3] = yPos

[4] = LineGap

[6] = MeanLineGap

[8] = BlockedFraction

[10] = ValidFraction

[11] = LineCounter。LineRate、MeanWidth、MeanLinePeriod、MeanLineGapが無効になります。

使用例

ImageStatisticsオペレーターの使用例を以下に示します。

  • 'Image Flow Control'

    例 - ハードウェアにおける設計の内部データフロー制御のデバッグおよび潜在的な補正を目的としています。