Min_Sampled()

Format

Min_Sampled(Expr ,StartTime [,EndTime])

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

Returns

Returns the minimum value of the points in an expression 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 sample-based minimum, that is, it finds the minimum of all of the values within the time range. This is most appropriate when calculating the minimum of a batch-based quantity, such as the moisture content of coal shipments.

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

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

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

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

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