Operator Library: Debugging
「ImageStatistics」運算子會測量整個幀序列的幀屬性，而無需觸及影像資料。
「OperatorImageStatistics」運算子用於分析影像序列。 若要分析單張影像，請使用「OperatorImageAnalyzer」運算子。
此運算子可分析幀與幀之間的偏差（寬度、高度、大小、行間距等）。 此運算子亦提供有關行速率與幀速率的測量參數。
此外，ImageStatistics運算子會提供有關管線容量利用率的資料 （有效時間比例、閒置時間比例及阻塞時間比例，單位為百分比）。
當內部計數器發生溢出時， 「溢出遮罩」（OverflowMask）參數中的對應溢出位元會被設定，且計數器將停止運作。
![[重要]](../common/images/admon/important.png) |
執行階段測試 |
|---|---|
|
此運算子專為在執行階段測試與分析您的設計而設計： 在您使用此運算子進行偵錯之前，必須先建置 (合成) 設計、将其載入目標硬體，並啟動實際的影像處理。 該運算子並非用於 VisualApplets 內的設計模擬。 |
| 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 | |
|---|---|
| Type | dynamic write parameter |
| Default | ClearWithProcessStart |
| Range | {NoClearing, ClearWithProcessStart, ClearWithProcessReset, SendClearPulse} |
|
此參數定義所有 read 參數的重設行為。 NoClearing：所有讀取參數的數值均予以保留。 ProcessEnable 與 ProcessReset 不會影響這些數值。 ClearWithProcessStart：讀取參數的值僅會在 ProcessEnable 訊號的上升沿時被清除。 ClearWithProcessReset: 讀取參數的值僅會在 ProcessReset 的上升沿時被清零。 SendClearPulse: 按需清除所有已讀取的參數值。 |
|
| MeasurementPeriod | |
|---|---|
| Type | 動態讀取參數 |
| Default | 1000 |
| Range | [1, 65535] |
|
用於測量頻率與占空比的時間（單位：毫秒）。 . |
|
| FrameCountWidth | |
|---|---|
| Type | 靜態寫入參數 |
| Default | 24 |
| Range | [4, 63] |
|
設定幀計數器（參數FrameCount）的位元寬度。 |
|
| GapCountWidth | |
|---|---|
| Type | 靜態寫入參數 |
| Default | 20 |
| Range | [4, 63] |
|
設定行間距計數器（MinLineGap、MaxLineGap、MeanLineGap、MinLinePeriod、MaxLinePeriod、MeanLinePeriod）的位元寬度。 |
|
| FrameCount | |
|---|---|
| Type | 動態讀取參數 |
| Default | 0 |
| Range | [0, (2^FrameCountWidth) - 1] |
|
統計所有以 EndOfFrame 結尾的影像。僅在 IMAGE-2D 模式下可用。 |
|
| FramePixelCount | |
|---|---|
| Type | 動態讀取參數 |
| Default | 0 |
| Range | [0, (2^(ImageWidthBitwidth + ImageHeightBitwidth + 4)) - 1] |
|
最後一個完成的幀的尺寸（以像素為單位）。 |
|
| MinWidth | |
|---|---|
| Type | 動態讀取參數 |
| Default | 0 |
| Range | [0, (2^(ImageWidthBitwidth+4))-1] |
|
迄今為止檢查的所有幀中，偵測到的最小線寬（以像素為單位）。 |
|
| MaxWidth | |
|---|---|
| Type | 動態讀取參數 |
| Default | 0 |
| Range | [0, (2^(ImageWidthBitwidth+4))-1] |
|
迄今為止檢查過的所有幀中偵測到的最大線寬（單位：像素）。 |
|
| MinHeight | |
|---|---|
| Type | 動態讀取參數 |
| Default | 0 |
| Range | [0, (2^(圖片高度 × 位元寬度 + 4)) - 1] |
|
迄今為止檢查的所有幀中偵測到的最小影像高度（以像素為單位）。 |
|
| MaxHeight | |
|---|---|
| Type | 動態讀取參數 |
| Default | 0 |
| Range | [0, (2^(圖片高度 × 位元寬度 + 4)) - 1] |
|
迄今為止檢查過的所有幀中偵測到的最大影像高度（以像素為單位）。 |
|
| MinPixelCount | |
|---|---|
| Type | 動態讀取參數 |
| Default | 0 |
| Range | [0, (2^(圖片寬度位元寬度 + 圖片高度位元寬度 + 4)) - 1] |
|
迄今為止檢查過的所有幀中，最小的幀尺寸（以像素為單位）。 |
|
| 最大像素數 | |
|---|---|
| Type | 動態讀取參數 |
| Default | 0 |
| Range | [0, (2^(圖片寬度位元寬度 + 圖片高度位元寬度 + 4)) - 1] |
|
迄今為止所有已檢查畫面中，最大畫面的尺寸（以像素為單位）。 |
|
| MinLineGap | |
|---|---|
| Type | 動態讀取參數 |
| Default | 0 |
| Range | [0, (2^GapCountWidth)-1] |
|
迄今為止檢查的所有幀中，均發現行間距極小。 此處不包含 2D 影像最後一行 與下一張影像第一行之間的幀間距。  |
|
| MaxLineGap | |
|---|---|
| Type | 動態讀取參數 |
| Default | 0 |
| Range | [0, (2^GapCountWidth)-1] |
|
迄今為止檢查過的所有幀中所遇到的最大行間距。 此數值不包含 2D 影像最後一行 與下一張影像第一行之間的幀間距。 |
|
| MinLinePeriod | |
|---|---|
| Type | 動態讀取參數 |
| Default | 0 |
| Range | [0, (2^GapCountWidth)-1] |
|
偵測到最小行週期。 行週期是指兩個行起始點之間所需的時鐘週期數。 因此，一個行週期涵蓋了行寬、單一的「行尾」脈衝，以及行間隙。 2D 影像的最後一行 與下一張影像的第一行之間的幀間隙不包含在內。  |
|
| MaxLinePeriod | |
|---|---|
| Type | 動態讀取參數 |
| Default | 0 |
| Range | [0, (2^GapCountWidth)-1] |
|
遇到最大行週期。 行週期是指兩個行起點之間所需的時鐘週期數。 因此，一個行週期涵蓋了行寬、單一的「行尾」脈衝，以及行間隙。 2D 影像的最後一行與 下一張影像的第一行之間的幀間隙並不包含在內。 |
|
| 平均寬度 | |
|---|---|
| Type | 動態讀取參數 |
| Default | 0 |
| Range | [0, (2^(ImageWidthBitwidth+4))-1] |
|
在指定的 MeasurementPeriod 期間內的平均線寬（以像素為單位）。 |
|
| 平均線週期 | |
|---|---|
| Type | 動態讀取參數 |
| Default | 0 |
| Range | [0, (2^GapCountWidth)-1] |
|
在 MeasurementPeriod 期間的平均行週期。行週期是指兩個行起點之間的時鐘週期數。 因此，一個行週期涵蓋了行寬、單一的 EndOfLine 脈衝，以及行間隙。 2D 影像的最後一行與下一張影像的第一行之間的幀間隙不包含在內。 |
|
| MeanLineGap | |
|---|---|
| Type | 動態讀取參數 |
| Default | 0 |
| Range | [0, (2^GapCountWidth)-1] |
|
在設定的 MeasurementPeriod 期間內的平均行間距（兩行起始點之間平均的時鐘週期數）。 2D 影像的最後一行與下一張影像的第一行之間的幀間距不包含在內。 |
|
| 平均線性占空比 | |
|---|---|
| Type | 動態讀取參數 |
| Default | 0 |
| Range | [0.0, 100.0] |
|
在設定的 MeasurementPeriod 期間內的平均線寬佔比。 定義為 MeanWidth 除以 MeanLinePeriod。 |
|
| LineRate | |
|---|---|
| Type | 動態讀取參數 |
| Default | 0 |
| Range | |
|
線速，單位為赫茲。 |
|
| 幀率 | |
|---|---|
| Type | 動態讀取參數 |
| Default | 0 |
| Range | |
|
幀率以赫茲為單位。 |
|
| 被封鎖的比例 | |
|---|---|
| Type | 動態讀取參數 |
| Default | 0 |
| Range | [0.0, 100.0] |
|
被阻斷週期的百分比。 |
|
| 閒置比例 | |
|---|---|
| Type | 動態讀取參數 |
| Default | 0 |
| Range | [0.0, 100.0] |
|
閒置週期的百分比。 |
|
| ValidFraction | |
|---|---|
| Type | 動態讀取參數 |
| Default | 0 |
| Range | [0.0, 100.0] |
|
攜帶資料的有效週期的百分比。 |
|
| MaxWidthErrorCount | |
|---|---|
| Type | 動態讀取參數 |
| Default | 0 |
| Range | [0, (2^(ImageWidthBitwidth+4))-1] |
|
若線寬大於輸入連結上定義的最大線寬，則進行計數。 |
|
| 最大錯誤次數上限 | |
|---|---|
| Type | 動態讀取參數 |
| Default | 0 |
| Range | [0, (2^( 圖像高度 × 位元寬度 + 4)) - 1] |
|
若圖片高度大於輸入連結中定義的最大圖片高度，則計數器會增加。 |
|
| 溢出遮罩 | |
|---|---|
| Type | 動態讀取參數 |
| Default | 0 |
| Range | [0, 4095] |
|
位元編碼的溢出訊號。若某位元被設定，表示以下計數器發生溢出： [0] = 幀數 [1] = 像素數 [2] = xPos [3] = yPos [4] = 行距 [6] = MeanLineGap [8] = 被封鎖比例 [10] = ValidFraction [11] = LineCounter。會使 LineRate、MeanWidth、MeanLinePeriod 及 MeanLineGap 失效。 |
|
以下範例展示了運算子 ImageStatistics 的使用方式：
-
範例 - 用於對硬體中的設計內部資料流控制進行偵錯以及進行可能的補償。
上一頁
