ContinuousMin_Sampled()

Format

ContinuousMin_Sampled(Expr ,StartTime [,EndTime])

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

Returns

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

Inputs

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

StartTime: The start time over which to produce the minimum. 
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 minimum. 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 minimum, 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 minimum.

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: ContinuousMin_Sampled(Expr, Time() - 60, Time())
Result: Minimum over the last minute (60 seconds).

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

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

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

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