Range (Tag-based PE function)

Find the difference between a point's maximum and minimum values during a given time, according to values stored in the PI Archive.

Syntax

Range(tagname, starttime, endtime [, pctgood])

Arguments

tagname

A tagname. This point should represent a continuous variable.

starttime

Must be a time expression, the beginning of the time range to search.

endtime

Must be a time expression, greater than starttime; the end of the time range to search.

pctgood

Optional. Minimum time percentage, over the given time range, that the point's archived values must be good.

Returns

The difference between the point's maximum and minimum values during the given time.

Exceptions

If the point has no good values or the pctgood minimum is not reached in the given time range, returns an error value.

Notes

Note: The OverRangeStat and UnderRangeStat digital states are not taken into account when calculating Range.

Example

Range('tag1', 'y', '*')

Range('tag1','-1h', 'y')

Range('tag1','y', '+1h',70)