オペレーター StreamAnalyzer

Operator Library: Debugging

オペレーター StreamAnaylzer は、データフローに関する情報を提供します。画像データには干渉しません。

このオペレーターを使用して、ブロッキング(抑制)条件を検出しことができます。

パイプラインでブロッキングが発生した場合、このオペレーターを使用すると、フレーム内のどこで(どのピクセルで)ブロッキングが発生したかを確認できます。

さらに、オペレーター StreamAnalyzer は、パイプライン容量の使用率に関するデータ(有効な時間の割合、アイドル状態の時間の割合、ブロックされた時間の割合をパーセンテージで表示)を提供します。

内部 Counter がオーバーフローすると、対応するオーバーフロービットが OverflowMask パラメータに設定され、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, LINE1D, PIXEL0D 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 パラメータの値をオンデマンドでクリアします。

MeasurementMode
タイプ 動的書き込みパラメータ
Default AllCycles
範囲 {AllCycles, FrameCyclesOnly, LineCyclesOnly}

このパラメータを使用すると、MeasurementPeriodの特定の割合を分析できます。

AllCycles: MeasurementPeriod内のすべてのサイクルにわたってパフォーマンスが測定されます。

FrameCyclesOnly: フレームの開始から終了までのすべてのサイクルにわたってパフォーマンスが測定されます。したがって、MeasurementPeriod内のフレームギャップは除外されます。

LineCyclesOnly: ラインの開始から終了までのすべてのサイクルにわたってパフォーマンスが測定されます。したがって、MeasurementPeriod内のフレームギャップおよびラインギャップは除外されます。

MeasurementPeriod
タイプ 動的書き込みパラメータ
Default 1000
範囲 [1, 65535]

パフォーマンス測定の時間(ミリ秒)。

測定期間の定義は、時間の割合を分析し、平均値を計算する上で重要です。

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

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

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

測定期間の開始からの経過時間(ミリ秒)。

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

このパラメータはフレームCounterとして機能します。EndOfFrameフラグで終了したすべてのフレームがカウントされます。IMAGE-2Dモードでのみ使用可能です。

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

1に設定した場合:値1は、画像フローがブロックされていることを通知します。

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

1つのフレームが流れる間に、画像フローがブロックされているクロックサイクルの数をカウントします。

ピクセルギャップの長さは、常にそのギャップを引き起こしたブロッキングの長さと正確に一致します。ただし、ギャップのオフセットは、ブロッキング状態のオフセットとは異なる場合があります。

処理ラインの上流にバッファオペレーターが実装されている場合、ブロッキング状態のために転送できなかったピクセルはバッファリングされます。

処理ラインの上流にバッファオペレーターが実装されていない場合、ブロッキング状態のために転送できなかったピクセルは破棄されます。

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

最初にブロッキングが発生したフレームのフレーム番号。

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

最後のブロッキングが発生したフレームのフレーム番号。

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

最初にブロッキングが現れた水平位置。

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

画像フローがブロックされていた、現在までの最後の水平位置。

例:値が 7 の場合、水平位置 7 は現在までにブロックされた最後の X 位置でした。水平位置 8 は、発生した最後のブロッキングの後の最初のブロック解除された位置でした。

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

最初にブロッキングが現れた垂直位置。

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

画像フローがブロックされていた、現在までの最後の垂直位置。

例:値が 13 の場合、垂直位置 13 は現在までにブロックされた最後の Y 位置でした。垂直位置 14 は、発生した最後のブロッキングの後の最初のブロック解除された位置でした。

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

最初にブロッキングが現れたタイムスタンプ。

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

最後のブロッキングが現れた時点のタイムスタンプ。

この時点以降、現在までさらなるブロッキングは発生していません。

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

秒間メガピクセル単位で測定されたデータレート。

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

測定期間内におけるブロックされたサイクルの割合(MeasurementPeriodパラメータを参照)。

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

測定期間内におけるアイドルサイクルの割合(MeasurementPeriodパラメータを参照)。

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

測定期間内におけるデータを運ぶ有効なサイクルの割合(MeasurementPeriodパラメータを参照)。

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

オペレーターコントロール:

ビットエンコードされたオーバーフロー信号。セットされたビットは、次の Counter でオーバーフローが発生していることを示します:

[0] = FrameCount

[1] = PixelCount

[2] = xPos

[3] = yPos

[4] = LinePeriod

[5] = InhibitCount

[6] = InhibitCountFrame

[7] = IdleCount

[8] = ValidCount

使用例

StreamAnalyzerオペレータの使用方法は、以下の例に示されています。

  • 'Image Dimension Test'

    例 - 画像寸法が測定され、デザインフローの分析に使用できます。

  • 'Image Timing Generator'

    例 - ジェネレータによって画像タイミングが提供されている間、デザインのデータフローを解析できます。