Operator ImageStatistics

Operator Library: Debugging

算子 ImageStatistics 用于测量整个图像序列的帧属性，而不修改图像数据。

算子 ImageStatistics 用于分析图像序列。 如需分析单幅图像，请使用算子 ImageAnalyzer。

该算子可用于分析帧与帧之间的偏差（宽度、高度、大小、行间距等）。 该算子还提供有关行速率和帧速率的测量值。

此外，算子 ImageStatistics 还提供有关流水线容量利用率的数据 （有效时间占比、空闲时间占比、阻塞时间占比，以百分比表示）。

当内部 Counter 溢出时， OverflowMask 参数中相应的溢出位将被置位，并且 Counter 停止。

[重要] 运行时测试

此算子专为在运行时测试和分析您的设计而设计： 您需要构建（综合）设计、将其加载到目标硬件上并开始实际图像处理， 然后才能使用该算子进行调试。

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

I/O Properties

财产 值
操作员类型 O
Input Link I，图像数据输入
输出链接 O，图像数据输出

Supported Link Format

链接参数 输入链路 I 输出链路 O
Bit Width [1, 64] as I
Arithmetic {unsigned, signed} as I
Parallelism 任何 as I
内核列 任何 as I
内核行 任何 as I
图像协议 {VALT_IMAGE2D, VALT_LINE1D} as I
Color Format 任何 as I
颜色口味 任何 as I
Max. Img Width 任何 as I
Max. Img Height 任何 as I

参数

ClearMode
键入 动态写入参数
默认 ClearWithProcessStart
范围 {NoClearing, ClearWithProcessStart, ClearWithProcessReset, SendClearPulse}

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

NoClearing：保留所有 read 参数的值。ProcessEnable 和 ProcessReset 对这些值没有影响。

ClearWithProcessStart：仅在 ProcessEnable 的上升沿清除 read 参数的值。

ClearWithProcessReset：仅在 ProcessReset 的上升沿清除 read 参数的值。

SendClearPulse：按需清除所有 read 参数的值。

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

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

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

设置帧 Counter 的 Bit Width（参数 FrameCount）。

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

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

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

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

帧像素计数
键入 动态读取参数
默认 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]

迄今为止检查的所有帧中遇到的最小行间距。 不包含二维图像最后一行与下一图像第一行之间的帧间距。

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

迄今为止检查的所有帧中遇到的最大行间距。 不包含二维图像最后一行与下一图像第一行之间的帧间距。

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
范围

以赫兹 (Hertz) 为单位的行频。

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

以赫兹 (Hertz) 为单位的帧频。

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 失效。

Examples of Use

以下示例展示了 ImageStatistics 算子的用法：

  上一页     返回上一级     下一步  
内容 顶部 主页