TotalRun (Running Total)
The TotalRun instruction is used to output a running total of a measurement.
Syntax
TotalRun ( Dest, Reps, Source, Number, RunReset [optional] )
Example
The following simple program shows the use of the TotalRun instruction. A running total is kept over 100 values.The RunTotal variable is increment by 2 with each program scan. The running total can be reset by setting the Boolean value, RunReset, to True, or it is set automatically under program control once the running total equals 200.
Public RunReset As Boolean, Counter As Long, RunTotal 'As Long
DataTable (Count,True,-1)
DataInterval (0,5,sec,10)
Sample (1,Counter,Long)
EndTable
BeginProg
Scan (1,Sec,3,0)
Counter=2
TotalRun (RunTotal,1,Counter,100,RunReset OR RunTotal>=200)
If RunReset=True Then RunReset=False
CallTable (Count)
NextScan
EndProg
Remarks
This instruction, when used, must appear between the Scan … NextScan instructions. A running total is the total of the last N values where N is specified in the Number argument. Until the datalogger has taken N measurements the total is calculated based on the number of actual measurements made.
The running total is calculated from the non-NAN Not a number. A data word indicating a measurement or processing error. Voltage overrange, SDI-12 sensor error, and undefined mathematical results can produce NAN. values in the buffer of historical data. In the event that all values in the buffer are NAN, the output will be 0. The TotalRun instruction should be called conditionally (only when good values are received) to avoid NAN values affecting the output. When called conditionally, the total is calculated as the total of the last number of good values.
Parameters
Dest (Destination)
The Variable in which to store the results of the instruction. Right-click the parameter to display a list of defined variables.
If this instruction has a Repetitions parameter and it is greater than 1, the results are stored in an array with the variable name. The array must be dimensioned large enough to hold all of the values returned from all of the Reps.
Type: Variable or Array
Reps (Repetitions)
The number of repetitions for the measurement or instruction.
Type: Constant integer (or expression that evaluates as a constant).
For the TotalRun instruction, the Reps parameter is the number of variables in the array for which a running total should be calculated. When the Source is not an array, or only a single variable in the array should be totaled, Reps should be 1.
Source
The name of the Variable that is the input for the instruction. Right-click the parameter to display a list of defined variables.
Type: Variable
Number
The number of values of Source to be used for calculating the running average, running total, running minimum, running maximum, or running standard deviation.
Type: Constant (or expression that evaluates as a constant)
Optional Parameter
RunReset
When RunReset is true, the history over which the running value (for example, running average, running maximum, running minimum, running total, or running standard deviation) is calculated is cleared, so that the value returned is calculated from a a single value, the current input. Note that the reset parameter does not automatically toggle back to false once set to true. When the reset parameter is set back to false (problematically or manually), then the running average, running maximum, running minimum, or running total continues, starting with the current input. Note that until the data logger has taken N measurements, the running average/total/maximum/minimum is calculated based on the actual number of measurements made since reset was set back to false.
Type: Boolean Data type used to represent conditions or hardware that have only two states (true or false) such as flags and control ports. variable or expression that evaluates true/false
NOTE: This instruction uses high precision math A normal single precision float has 24 bits of mantissa. With high precision, a 32 bit extension of the mantissa is saved and used internally, resulting in 56 bits of precision. Instructions that use high precision are Average, AvgRun, AvgSpa, CovSpa, MovePrecise, RMSSpa, StdDev, StdDevSpa, TotalRun, and Totalize.. A normal single precision float has 24 bits of mantissa. With high precision, a 32 bit extension of the mantissa is saved and used internally, resulting in 56 bits of precision. Instructions that use high precision are