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 Properties

Property Value
Operator Type M
Input Link I,Image Input
Output Link O, Data Output

支援的 Link 格式

Link Parameter Input Link I Output Link O
Bit Width [1, 16] 自動1
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 自動2
Max. Img Height any 自動3

1

輸出 Bit Width取決於 max image dimension link properties 以及 AutoSync 參數的設定。

對於 AutoSync = EoF,輸出 Bit Width 為

對於 AutoSync = EoL,輸出 Bit Width 為

Bit Width 不得超過 64 Bit。

2

輸出影像寬度由輸入 Bit Width 決定。輸入影像的每個可能像素值都由輸出影像的像素表示。

3

對於參數 AutoSync = EoF,輸出影像高度為一。對於參數 AutoSync = EoL,輸出影像高度等於輸入影像高度。

參數

AutoSync
Type static parameter
Default EoL
Range {EoL, EoF}

此參數選擇是每行(設定 EoL)還是每影格(設定 EoF)輸出直方圖。請注意該參數對輸出 Bit Width 的影響。輸出 Bit Width 不得超過 64 Bit。

使用範例

以下範例顯示了 Histogram 運算子的使用方式: