Shape reference

This section describes all available function shapes of Avelon and the meaning of their inputs and outputs.

Basic functions

The functions described in the following table cover the basic operations of mathematical calculations.

All functions work with a precision of minutes. This means that only the measurements which are recorded in the same minute are taken into account to produce a single result. For example, if you want to calculate a sum of different measurements, all the involved measurements must have been recorded within the same base interval.

Mathematical functions

Shape	Description
Sum	Calculates the sum of all inputs.
Subtraction	Subtracts the second input from the first one.
Product	Calculates the product of all inputs.
Division	Divides the first input by the second one.
Function / Constant	Represents a function with \(n\) inputs and one output. The special case \(n = 0\) represents a constant value. Also see Define functions and constants

Comparison functions

For all comparison functions, the output is set to 1 if the condition is fulfilled. Otherwise, the output is set to 0.

Shape	Description
Equal	Checks two inputs for equality.
Not equal	Checks two inputs for inequality.
Smaller than	Checks if the first input is smaller than the second one.
Smaller than or equal to	Checks if the first input is smaller than or equal to the second one.
Greater than	Checks if the first input is greater than the second one.
Greater than or equal to	Checks if the first input is greater than or equal to the second one.

Logic functions

For logical functions, 0 is generally interpreted as “false” whereas values ≠ 0 are interpreted as “true”.

Shape	Description
And	Combines all inputs with a logical And operation.
Or	Combines all inputs with a logical Or operation.
Not	Inverts the input.
Condition	Checks if the input a the top is true or false. If it is true, the output value is set to the first input, otherwise to the second input.

Extended functions

Similar to the basic functions, the advanced functions require a certain synchronicity of the input measurements, but this depends on the corresponding aggregation period. For example, if you calculate a daily average, all measurements within the same day will be taken into account.

Conversion functions

Shape	Description
Accumulation	Expects exactly one input and adds up all values continuously from the start of the entire recording duration.

Aggregation functions

Aggregation functions expect exactly one data point as input. Outputs of other calculations are not accepted as input. In order to aggregate a calculation nevertheless, you can buffer the result of the calculation into a separate data point and then use it as an input data point of the aggregation.

Shape	Description
Average	Calculates the arithmetic mean value for the entire selected time interval. The selected time interval is quantized (hour to start of hour, month to start of month, etc.) and can be configured directly as a property on the shape.
Minimum	Calculates the absolute minimum for the entire selected time interval. The selected time interval is quantized (hour to start of hour, month to start of month, etc.) and can be configured directly as a property on the shape.
Maximum	Calculates the absolute maximum for the entire selected time interval. The selected time interval is quantized (hour to start of hour, month to start of month, etc.) and can be configured directly as a property on the shape.
Sum	Sums the raw values for the entire selected time interval (integration). The selected time interval is quantized (hour to start of hour, month to start of month, etc.) and can be configured directly as a property on the shape.
Periodic difference	Calculates the average value for the entire selected time interval and subtracts it from the same value in the previous interval (differentiation). The selected time interval is quantized (hour to start of hour, month to start of month, etc.). Meter resets are taken into account in the calculation.

Time functions

Shape	Description
Operating Hours Counter	Expects the operating status and an (optional) reset switch as inputs. In addition, a constant value for the maximum permissible operating time between two maintenance operations can be set on the shape itself. This is used to calculate the effective operating time as well as a binary value for the maintenance notification, which can be used as an alarm data point, for example. However, the alarm notification is optional. The reset switch is required so that the maintenance status can be reset after maintenance has been carried out.
Time Shift (Dynamic)	Shifts the values of the input by the specified time difference.
Time Shift (Fixed Year)	Shifts the values of the input so that the values of the specified fixed year are returned.