Topic: DMD0157
AVGR - Average of a Range of Values
This instruction can only be used in the Expression parameter of the Calculate Expression (MATH) instruction.
The Average of a Range of Values (AVGR) math function calculates the average of the values in the specified range of variable locations.
Note: Use the F9 key to open the Default Element Selection Tool (the Element Picker or the Element Browser) or use the Down-Arrow key (Auto-Complete) on any parameter field to see a complete list of the memory locations that are valid for that parameter of the instruction.
Result specifies a location to store the result of the calculation. This can be any writable numeric location.
The Expression parameter consists of all the text between the bounding parentheses. Any expression parameter can be a constant value, a bit or numeric memory location, an arithmetic expression, and / or mathematical function or other expressions up to a maximum of 1024 characters. Expressions can be nested, so use of parentheses is recommended to ensure proper evaluation order.
This function itself has two parameters
The first parameter
designates the first location in the range of values. This can be any
readable bit data-block location or readable numeric data-block location.
The second parameter specifies the number of successive locations that are in the range. Note that this value is a count value, it does NOT specify the ending location. This can be any constant value from 1 to 65535, or, any regular math expression - for example (D3 - D1), or any readable numeric location.
This function always evaluates to a floating-point values.
If the second parameter (Range) is 0, the Result will be 0 and Argument Out of Range (ST132) will be ON.
If the second parameter exceeds the size of the data block , the result will be the sum of the values up to the last variable in the block and Argument Out of Range (ST132) will be ON. For example, assume the block of WX locations has a range of WX0 to WX255. The result of AVGR(WX250, 10) would be the average of the values in WX250 through WX255, and Argument Out of Range (ST132) will be ON.
See Also:
AVGR - Average of a Range of Values
MINR - Minimum Value Across a Range of Values
MAXR - Maximum Value Across a Range of Values
SUMR - Sum of a Range of Values
STDEVPR - Population Standard Deviation of a Range
STDEVR - Sample Standard Deviation of a Range
Related Topics:
MIN - Minimum Between Two Expressions
MAX - Maximum Between Two Expressions
Rung Example:
