Operator ImageStatistics

Operator Library: Debugging

Operator ImageStatistics measures frame properties for whole frame sequences without touching the image data.

Operator ImageStatistics analyzes image sequences. For analyzing individual images, use operator Operator ImageAnalyzer.

The operator allows to analyze deviations between frames (width, height, size, line gaps, etc.). The operator also provides measurands regarding line rates and frame rates.

In addition, operator ImageStatistics provides data about the utilization of the pipeline capacity (valid fraction, idle fraction, blocked fraction of time in percent).

When an internal counter overflows, a corresponding overflow bit is set in the OverflowMask parameter and the counter halts.

[Important] Runtime Testing

This operator is designed for testing and analyzing your design during runtime: You need to build (synthesize) the design, load it onto the target hardware, and start actual image processing, before you can use the operator for debugging.

The operator is not intended for design simulation within VisualApplets.

I/O Properties

Property
Operator Type O
Input Link I, image data input
Output Link O, image data output

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
键入 dynamic write parameter
默认 ClearWithProcessStart
范围 {NoClearing, ClearWithProcessStart, ClearWithProcessReset, SendClearPulse}

This parameter defines the reset behavior for all read parameters.

NoClearing: Values of all read parameters are held. ProcessEnable and ProcessReset have no influcence on these values.

ClearWithProcessStart: Values of read parameters are only cleared with rising edge of ProcessEnable.

ClearWithProcessReset: Values of read parameters are only cleared with rising edge of ProcessReset.

SendClearPulse: On-demand clearing of all read parameter values.

MeasurementPeriod
键入 dynamic read parameter
默认 1000
范围 [1, 65535]

Time in milliseconds for rate and duty cycle measurements. .

FrameCountWidth
键入 static write parameter
默认 24
范围 [4, 63]

Sets the bit width of the frame counter (parameter FrameCount).

GapCountWidth
键入 static write parameter
默认 20
范围 [4, 63]

Sets the bit width of the line gap counters (MinLineGap, MaxLineGap, MeanLineGap, MinLinePeriod, MaxLinePeriod, MeanLinePeriod).

FrameCount
键入 dynamic read parameter
默认 0
范围 [0, (2^FrameCountWidth) -1]

Counts all images which are terminated with an EndOfFrame. Available only in IMAGE-2D mode.

FramePixelCount
键入 dynamic read parameter
默认 0
范围 [0, (2^ (ImageWidthBitwidth+ImageHeightBitwidth+4))-1]

Size of the last completed frame in pixels.

MinWidth
键入 dynamic read parameter
默认 0
范围 [0, (2^(ImageWidthBitwidth+4))-1]

Minimal line width detected in all frames inspected so far (in pixels).

MaxWidth
键入 dynamic read parameter
默认 0
范围 [0, (2^(ImageWidthBitwidth+4))-1]

Maximal line width detected in all frames inspected so far (in pixels).

MinHeight
键入 dynamic read parameter
默认 0
范围 [0, (2^(ImageHeightBitwidth+4))-1]

Minimal image height detected in all frames inspected so far (in pixels).

MaxHeight
键入 dynamic read parameter
默认 0
范围 [0, (2^(ImageHeightBitwidth+4))-1]

Maximal image height detected in all frames inspected so far (in pixels).

MinPixelCount
键入 dynamic read parameter
默认 0
范围 [0, (2^(ImageWidthBitwidth+ImageHeightBitwidth+4))-1]

Size of smallest frame out of all frames inspected so far (in pixels).

MaxPixelCount
键入 dynamic read parameter
默认 0
范围 [0, (2^(ImageWidthBitwidth+ImageHeightBitwidth+4))-1]

Size of biggest frame out of all frames inspected so far (in pixels).

MinLineGap
键入 dynamic read parameter
默认 0
范围 [0, (2^GapCountWidth)-1]

Minimal line gap encountered in all frames inspected so far. Does not include the frame gap between the last line of a 2D image and the first line of the next image.

MaxLineGap
键入 dynamic read parameter
默认 0
范围 [0, (2^GapCountWidth)-1]

Maximal line gap encountered encountered in all frames inspected so far. Does not include the frame gap between the last line of a 2D image and the first line of the next image.

MinLinePeriod
键入 dynamic read parameter
默认 0
范围 [0, (2^GapCountWidth)-1]

Minimal line period encountered. A Line period is the number of clock cycles between two line beginnings. A line period thus covers the line width, a single EndOfLine pulse, and the line gap. The frame gap between the last line of a 2D image and the first line of the next image is not included.

MaxLinePeriod
键入 dynamic read parameter
默认 0
范围 [0, (2^GapCountWidth)-1]

Maximal line period encountered. A Line period is the number of clock cycles between two line beginnings. A line period thus covers the line width, a single EndOfLine pulse, and the line gap. The frame gap between the last line of a 2D image and the first line of the next image is not included.

MeanWidth
键入 dynamic read parameter
默认 0
范围 [0, (2^(ImageWidthBitwidth+4))-1]

Mean line width during set MeasurementPeriod (in pixels).

MeanLinePeriod
键入 dynamic read parameter
默认 0
范围 [0, (2^GapCountWidth)-1]

Mean line period during set MeasurementPeriod. A Line period is the number of clock cycles between two line beginnings. A line period thus covers the line width, a single EndOfLine pulse, and the line gap. The frame gap between the last line of a 2D image and the first line of the next image is not included.

MeanLineGap
键入 dynamic read parameter
默认 0
范围 [0, (2^GapCountWidth)-1]

Mean line gap during set MeasurementPeriod (mean number of clock cycles between two line beginnings).

The frame gap between the last line of a 2D image and the first line of the next image is not included.

MeanLineDutyCycle
键入 dynamic read parameter
默认 0
范围 [0.0, 100.0]

Mean line duty cycle during set MeasurementPeriod. Defined as MeanWidth divided by MeanLinePeriod.

LineRate
键入 dynamic read parameter
默认 0
范围

Line rate in Hertz.

FrameRate
键入 dynamic read parameter
默认 0
范围

Frame rate in Hertz.

BlockedFraction
键入 dynamic read parameter
默认 0
范围 [0.0, 100.0]

Percentage of blocked cycles.

IdleFraction
键入 dynamic read parameter
默认 0
范围 [0.0, 100.0]

Percentage of idle cycles.

ValidFraction
键入 dynamic read parameter
默认 0
范围 [0.0, 100.0]

Percentage of valid cycles carrying data.

MaxWidthErrorCount
键入 dynamic read parameter
默认 0
范围 [0, (2^(ImageWidthBitwidth+4))-1]

Counts up if line width is greater than maximum line width defined on the input link.

MaxHeightErrorCount
键入 dynamic read parameter
默认 0
范围 [0, (2^( ImageHeightBitwidth+4))-1]

Counts up if image height is greater than maximum image height defined on the input link.

OverflowMask
键入 dynamic read parameter
默认 0
范围 [0, 4095]

Bit encoded overflow signaling. A set bit indicates an overflow in the following counters:

[0] = FrameCount

[1] = PixelCount

[2] = xPos

[3] = yPos

[4] = LineGap

[6] = MeanLineGap

[8] = BlockedFraction

[10] = ValidFraction

[11] = LineCounter. Invalidates LineRate, MeanWidth, MeanLinePeriod and MeanLineGap.

Examples of Use

The use of operator ImageStatistics is shown in the following examples:

  • 'Image Flow Control'

    Example - For debugging purposes of the designs internal data flow control in hardware and a possible compensation.