ContinuousMax_Sampled()

Format

ContinuousMax_Sampled(Expr ,StartTime [,EndTime])

Note: This function was named Hist_ContinuousMax in v2.6.

Returns

Returns the maximum value at which an expression is held over a range of time.

Inputs

Expr: The expression whose values should be processed to find the maximum.
Behaviour: Required
Dimension: Collection
Valid data types: Boolean, DateTime, Decimal, Integer, String, Duration

StartTime: The start time over which to produce the maximum. 
Behaviour: Required
Dimension: Collection, SingleValue
Valid data types: DateTime, Decimal, Integer, String

Note: You can use the Time() function to use a valid DateTime argument.

EndTime: The end time over which to produce the maximum. If not specified, it assumes the current time. 
Behaviour: Optional 
Dimension: Collection, SingleValue
Valid data types: DateTime, Decimal, Integer, String

Note: You can use the Time() function to use a valid DateTime argument.

How to format data types

When to Use

This is a continuous maximum, that is, it takes into account that between the start of the time range and the first point within the range, the expression held its previous value and that value should be included in calculating the maximum.

It is possible to retrieve very large volumes of data through indiscriminate use of this function. Retrieving large amounts of Historian data across a slow network can affect system performance for all users of the system.

Examples

Expression: ContinuousMax_Sampled(Expr, Time() - 60, Time())
Result: Maximum over the last minute (60 seconds).

Expression: ContinuousMax_Sampled(Expr, Time() - 60)
Result: Maximum over the last minute (60 seconds).

Expression: ContinuousMax_Sampled(Expr, Midnight(Time()))
Result: Maximum since midnight (the start of the day).

Expression: ContinuousMax_Sampled({tag, sampleMethod = "Raw"}, Time() – 60)
Result: Maximum of the raw values over the last minute.

Expression: ContinuousMax_Sampled(Sampling(Expr, "raw"), Time() - 60)
Result: Maximum of the raw values over the last minute.