Operator ImageStatistics

Operator Library: Debugging

Operator ImageStatistics 用于测量整个图像序列的帧 Property,而无需接触图像数据。

Operator ImageStatistics 分析图像序列。若要分析单张图像,请使用 Operator ImageAnalyzer。

该算子允许分析帧之间的偏差(宽度、高度、大小、行间距等)。该算子还提供有关行速率和帧速率的测量值。

此外,Operator ImageStatistics 提供有关管道容量利用率的数据(有效时间占比、空闲时间占比、阻塞时间占比,以百分比表示)。

当内部 Counter 溢出时,OverflowMask parameter 中会设置相应的溢出位,并且 Counter 停止。

[重要] 运行时测试

此 operator 专为在运行时测试和分析您的设计而设计:您需要构建(综合)设计,将其加载到目标硬件上,并启动实际图像 processing,然后才能使用该 operator 进行调试。

该 operator 不适用于 VisualApplets 中的设计仿真。

I/O Property

Property 值
Operator Type O
Input Link I, image data input
Output Link O,图像数据输出

Supported Link Format

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
键入 动态写入参数
默认 ClearWithProcessStart
范围 {NoClearing, ClearWithProcessStart, ClearWithProcessReset, SendClearPulse}

此 Property 定义了所有 read Property 的重置行为。

NoClearing:保留所有 read Property 的值。ProcessEnable 和 ProcessReset 对这些值没有影响。

ClearWithProcessStart:仅在 ProcessEnable 的上升沿清除 read Property 的值。

ClearWithProcessReset:仅在 ProcessReset 的上升沿清除 read Property 的值。

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

MeasurementPeriod
键入 动态只读参数
默认 1000
范围 [1, 65535]

用于速率和占空比测量的毫秒级时间。

FrameCountWidth
键入 静态写参数
默认 24
范围 [4, 63]

设置帧 Counter 的 Bit Width(parameter FrameCount)。

GapCountWidth
键入 静态写参数
默认 20
范围 [4, 63]

设置行间距 Counter 的 Bit Width(MinLineGap、MaxLineGap、MeanLineGap、MinLinePeriod、MaxLinePeriod、MeanLinePeriod)。

FrameCount
键入 动态只读参数
默认 0
范围 [0, (2^FrameCountWidth) -1]

统计以 EndOfFrame 结束的所有图像。仅在 IMAGE-2D 模式下可用。

FramePixelCount
键入 动态只读参数
默认 0
范围 [0, (2^ (ImageWidthBitwidth+ImageHeightBitwidth+4))-1]

最后完成的帧的大小(以像素为单位)。

MinWidth
键入 动态只读参数
默认 0
范围 [0, (2^(ImageWidthBitwidth+4))-1]

迄今为止检查的所有帧中检测到的最小行宽(以像素为单位)。

MaxWidth
键入 动态只读参数
默认 0
范围 [0, (2^(ImageWidthBitwidth+4))-1]

迄今为止检查的所有帧中检测到的最大行宽(以像素为单位)。

MinHeight
键入 动态只读参数
默认 0
范围 [0, (2^(ImageHeightBitwidth+4))-1]

迄今为止检查的所有帧中检测到的最小图像高度(以像素为单位)。

MaxHeight
键入 动态只读参数
默认 0
范围 [0, (2^(ImageHeightBitwidth+4))-1]

迄今为止检查的所有帧中检测到的最大图像高度(以像素为单位)。

MinPixelCount
键入 动态只读参数
默认 0
范围 [0, (2^(ImageWidthBitwidth+ImageHeightBitwidth+4))-1]

迄今检测到的所有帧中最小帧的大小(以像素为单位)。

MaxPixelCount
键入 动态只读参数
默认 0
范围 [0, (2^(ImageWidthBitwidth+ImageHeightBitwidth+4))-1]

迄今检测到的所有帧中最大帧的大小(以像素为单位)。

MinLineGap
键入 动态只读参数
默认 0
范围 [0, (2^GapCountWidth)-1]

迄今检测到的所有帧中遇到的最小行间隙。 不包括 2D 图像最后一行与下一图像第一行之间的帧间隙。

MaxLineGap
键入 动态只读参数
默认 0
范围 [0, (2^GapCountWidth)-1]

迄今检测到的所有帧中遇到的最大行间隙。 不包括 2D 图像最后一行与下一图像第一行之间的帧间隙。

MinLinePeriod
键入 动态只读参数
默认 0
范围 [0, (2^GapCountWidth)-1]

遇到的最小行周期。 行周期是两个行起点之间的时钟周期数。 因此,行周期涵盖行宽、单个 EndOfLine 脉冲以及行间隙。 不包括 2D 图像最后一行与下一图像第一行之间的帧间隙。

MaxLinePeriod
键入 动态只读参数
默认 0
范围 [0, (2^GapCountWidth)-1]

遇到的最大行周期。 行周期是两个行起点之间的时钟周期数。 因此,行周期涵盖行宽、单个 EndOfLine 脉冲以及行间隙。 不包括 2D 图像最后一行与 下一图像第一行之间的帧间隙。

MeanWidth
键入 动态只读参数
默认 0
范围 [0, (2^(ImageWidthBitwidth+4))-1]

在设定的 MeasurementPeriod 期间的平均行宽(以像素为单位)。

MeanLinePeriod
键入 动态只读参数
默认 0
范围 [0, (2^GapCountWidth)-1]

在设定的 MeasurementPeriod 期间的平均行周期。行周期是两个行起点之间的时钟周期数。 因此,行周期涵盖行宽、单个 EndOfLine 脉冲以及行间隙。 不包括 2D 图像最后一行与下一图像第一行之间的帧间隙。

MeanLineGap
键入 动态只读参数
默认 0
范围 [0, (2^GapCountWidth)-1]

在设定的 MeasurementPeriod 期间的平均行间隙(两个行起点之间的平均时钟周期数)。

不包括 2D 图像最后一行与下一图像第一行之间的帧间隙。

MeanLineDutyCycle
键入 动态只读参数
默认 0
范围 [0.0, 100.0]

在设定的 MeasurementPeriod 期间的平均行占空比。 定义为 MeanWidth 除以 MeanLinePeriod。

LineRate
键入 动态只读参数
默认 0
范围

以赫兹为单位的行频。

FrameRate
键入 动态只读参数
默认 0
范围

以赫兹为单位的帧率。

BlockedFraction
键入 动态只读参数
默认 0
范围 [0.0, 100.0]

阻塞周期的百分比。

IdleFraction
键入 动态只读参数
默认 0
范围 [0.0, 100.0]

空闲周期的百分比。

ValidFraction
键入 动态只读参数
默认 0
范围 [0.0, 100.0]

传输有效数据的有效周期百分比。

MaxWidthErrorCount
键入 动态只读参数
默认 0
范围 [0, (2^(ImageWidthBitwidth+4))-1]

如果行宽大于输入链路上定义的线宽最大值,则该计数器递增。

MaxHeightErrorCount
键入 动态只读参数
默认 0
范围 [0, (2^( ImageHeightBitwidth+4))-1]

如果图像高度大于输入链路上定义的图像高度最大值,则该计数器递增。

OverflowMask
键入 动态只读参数
默认 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'

    示例 - 用于在硬件中调试设计内部数据流控制及可能的补偿。