Operator ImageStatistics

Operator Library: Debugging

Operator ImageStatistics 會測量整個畫格序列的畫格屬性,而不會更動影像資料。

Operator ImageStatistics 會分析影像序列。 若要分析個別影像,請使用 operator ImageAnalyzer。

此 operator 可用於分析畫格之間的偏差(寬度、高度、大小、行間距等)。 此外,該 operator 也提供有關行速率和畫格速率的量測值。

此外,operator ImageStatistics 還提供有關管線容量利用率的資料 (有效時間、閒置時間、封鎖時間的百分比)。

當內部 Counter 溢位時, 會在 OverflowMask 參數中設定對應的溢位位元,並且 Counter 會停止。

[重要] 執行階段測試

此 operator 旨在於執行階段測試和分析您的設計:您需要建置(合成)設計、將其載入目標硬體,並啟動實際的影像處理,然後才能使用該 operator 進行偵錯。

此 operator 並非用於 VisualApplets 內的設計模擬。

I/O Properties

Property Value
Operator Type O
Input Link I,影像資料輸入
Output Link O, 影像資料輸出

支援的 Link 格式

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 動態寫入參數
Default ClearWithProcessStart
Range {NoClearing, ClearWithProcessStart, ClearWithProcessReset, SendClearPulse}

此參數定義所有 read 參數的重設行為。

NoClearing: 保留所有 read 參數的值。 ProcessEnable 和 ProcessReset 對這些值沒有影響。

ClearWithProcessStart: 只有在 ProcessEnable 的載上升緣時,才會清除 read 參數的值。

ClearWithProcessReset: 只有在 ProcessReset 的載上升緣時,才會清除 read 參數的值。

SendClearPulse: 按需清除所有 read 參數的值。

MeasurementPeriod
Type 動態讀取參數
Default 1000
Range [1, 65535]

用於速率和工作週期測量的时间(以毫秒為單位)。

FrameCountWidth
Type 靜態寫入參數
Default 24
Range [4, 63]

設定畫格 Counter 的 Bit Width(參數 FrameCount)。

GapCountWidth
Type 靜態寫入參數
Default 20
Range [4, 63]

設定行間距 Counter 的 Bit Width(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^(ImageHeightBitwidth+4))-1]

迄今檢查的所有影格中偵測到的最小影像高度 (以像素為單位)。

MaxHeight
Type 動態讀取參數
Default 0
Range [0, (2^(ImageHeightBitwidth+4))-1]

迄今檢查的所有影格中偵測到的最大影像高度 (以像素為單位)。

MinPixelCount
Type 動態讀取參數
Default 0
Range [0, (2^(ImageWidthBitwidth+ImageHeightBitwidth+4))-1]

迄今檢查的所有影格中最小影格的大小 (以像素為單位)。

MaxPixelCount
Type 動態讀取參數
Default 0
Range [0, (2^(ImageWidthBitwidth+ImageHeightBitwidth+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]

遇到的最小行週期。 行週期是指兩個行開頭之間的時脈週期數。 因此,行週期涵蓋行寬、單個 EndOfLine 脈衝以及行間隙。 不包含 2D 影像最後一行與 下一影像第一行之間的影格間隙。

MaxLinePeriod
Type 動態讀取參數
Default 0
Range [0, (2^GapCountWidth)-1]

遇到的最大行週期。 行週期是指兩個行開頭之間的時脈週期數。 因此,行週期涵蓋行寬、單個 EndOfLine 脈衝以及行間隙。 不包含 2D 影像最後一行與 下一影像第一行之間的影格間隙。

MeanWidth
Type 動態讀取參數
Default 0
Range [0, (2^(ImageWidthBitwidth+4))-1]

設定的 MeasurementPeriod 期間的平均行寬 (以像素為單位)。

MeanLinePeriod
Type 動態讀取參數
Default 0
Range [0, (2^GapCountWidth)-1]

在設定的 MeasurementPeriod 期間的平均行週期。行週期是兩個行開頭之間的時脈週期數。 因此,行週期涵蓋行寬、單個 EndOfLine 脈衝以及行間隙。 不包含 2D 影像最後一行與下一影像第一行之間的影格間隙。

MeanLineGap
Type 動態讀取參數
Default 0
Range [0, (2^GapCountWidth)-1]

在設定的 MeasurementPeriod 期間的平均行間隙(兩個行開頭之間的平均時脈週期數)。

不包含 2D 影像最後一行與下一影像第一行之間的影格間隙。

MeanLineDutyCycle
Type 動態讀取參數
Default 0
Range [0.0, 100.0]

在設定的 MeasurementPeriod 期間的平均行工作週期。 定義為 MeanWidth 除以 MeanLinePeriod。

LineRate
Type 動態讀取參數
Default 0
Range

以赫茲 (Hertz) 為單位的心跳速率 (Line rate)。

FrameRate
Type 動態讀取參數
Default 0
Range

以赫茲為單位的影格率。

BlockedFraction
Type 動態讀取參數
Default 0
Range [0.0, 100.0]

受阻擋週期的百分比。

IdleFraction
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]

如果行寬大於輸入鏈結上定義的最大行寬,則開始計數。

MaxHeightErrorCount
Type 動態讀取參數
Default 0
Range [0, (2^( ImageHeightBitwidth+4))-1]

如果影像高度大於輸入鏈結上定義的最大影像高度,則開始計數。

OverflowMask
Type 動態讀取參數
Default 0
Range [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'

    範例 - 用於偵錯硬體中設計的內部資料流控制以及可能的補償。