Integrator (Time Resetable) block
This block calculates the integral of a field. The integral may be restarted by an event.
Integrator (Time Resetable) block
Description
This block calculates the integral of a field on a per second basis. It keeps a history of input values for each input field. The window span setting controls the duration of the history. The integral value may be restarted from any point, and the user sets the maximum history window over which it will integrate. A reset event is triggered by the Reset on Input change block, where the reset event is a trigger value.
DIAGRAM SHOWING THE INTEGRATOR (TIME resetable) BLOCK
Block Type
Time based block
Input/Output ports
Information parsed to the input port (list input fields/ tags in a Normal list).
The block can only accept fields of type Double. There is an output field for every input field. Output fields are created automatically to match the input fields. New output field names can have a post-fix applied, the post-fix is configurable by the user or the user can assign a new output tag name by editing the output field.
From a runnability requirement point of view, the input must be connected to a source that only has fields of type double, and the window span must be larger than 0.
Functions performed on tags
-
On the values - The output value is the integral of the input values as calculated per second. When a reset event occurs the integral is recalculated starting from the time specified in the reset event. If the reset event time is the current execution time the integral will restart at 0.
-
On the timestamp - The increment is based on seconds and the integration uses the timestamp to calculate the integrated value. The execution time stamp is set on the output fields.
-
On the quality - The output quality of the integrator block is good as long as each of the consecutive values is of good quality between two reset events. If one input sample has bad quality the output quality is set to bad, until the next reset event.
Example
The table below shows the input to the integrator block and the quality of the input, the input to the reset on input change block (Input_Reset_Block), as well as the output and output quality from the integrator block. The actual value is indicated by Minute_Value column, which is a value that is read per minute, whereas the Input column indicates the input to the integrator block based on seconds, i.e. [Minute_Value/60 seconds = Input in seconds]. This is necessary because the integrator block assumes a time increment of a second, therefore, based on the timestamp the integrator blocks integrates the value for that period. The reset on input change block is configured to sample on the rising edge of the value, Input_Reset_Block. Thus whenever a reset event occurs the integration is zeroed. In the case where an input value has a bad quality the integrated output is set to bad quality until the next reset event.
Related topics: