FindGE (Tag-based PE function)

Find the first or last time, within a range, when a point is greater than or equal to a given value.

Syntax

FindGE(tagname, starttime, endtime, value)

Arguments

tagname

A tagname.

starttime

A time expression representing the beginning of the time range to search or a time relative to endtime, if endtime is a time.

endtime

A time expression representing the end of the time range to or a time (in seconds) relative to starttime, if starttime is a time. If endtime is earlier than starttime, the range is searched backwards.

value

Must be an integer or real number or digital state (character string), the value to search for.

Returns

The timestamp closest to starttime, within the given range, for which the point was greater than or equal to the given value.

Exceptions

If the point was always less than the given value, FindGE returns an error value.

Notes

FindGE interpolates between archive events, if necessary, to find the value it is looking for.

Example

FindGE('tag1', 't', '*',40.0)

FindGE('digitaltag', '-1d', '*', TagVal('digitaltag', '14-Dec-97'))

FindGE('tag1', '-1d', '*','tag2')