Operator FrameSum

Operator Library: Accumulator

This operator computes the sum of all pixel values for each input frame. The output frame has the same size as the input frame, where each pixel is replaced by the current frame sum. Thus, each pixel is replaced by the pixel sum determined so far.

[Note] Resource Consumption

The operator's FGPA resource consumption strongly increases with the parallelism. We recommend to use low parallelism at this operator.

In many use cases of this operator, the parallelism can be reduced by adding up the parallel components prior this operator using SplitParallel and ADD.

With every new input frame the summation starts from zero. Additionally, it is possible to clear the current sum manually when the ClrI link is set to 1. When a manual clearing is not necessary, you must ensure a constant 0 at ClrI, to enable normal operation.

The following example shows the relation of input values to output values.

Often, this operator is used in conjunction with operators RemoveLine and RemovePixel to use only the last image pixel containing the results of all frame pixels.

Image Restrictions

  • Image size

    Varying line lengths and empty lines are allowed in non-empty images.

  • Empty Images

    Empty images, i.e., images with no pixels, are allowed. The operator will output an empty image.

I/O Properties

Property Value
Operator Type O
Input Links I, Image Input
ClrI, Clear Input
Output Link O, Data Output

Supported Link Format

Link Parameter Input Link I Input Link ClrI Output Link O
Bit Width [1, 64] unsigned, [2, 64] signed 1 auto1
Arithmetic {unsigned, signed} unsigned as I
Parallelism any as I as I
Kernel Columns 1 as I as I
Kernel Rows 1 as I as I
Img Protocol VALT_IMAGE2D as I as I
Color Format VAF_GRAY as I as I
Color Flavor FL_NONE as I as I
Max. Img Width any as I as I
Max. Img Height any as I as I

1

The output bit width is automatically determined from the input bit width and maximum image dimension. The output bit width is determined by

The output bit width must not exceed 64 Bit.

Parameters

None

Examples of Use

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

  • 'Auto Threshold Mean'

    Determines the mean value of an image and used the value as threshold value for the next image processed.