sample Structure: Description for sampling.

sample structure
source source type
initial delay integer: optional
frequency integer: optional
window integer: optional, default
limit integer: optional
criteria array of sample criterion: optional, unique


sample describes the constraints and criteria for sampling the environment and determining a result. sample provides a generic solution to a class of common situations that require near constant monitoring of external events.



Source of samples.

initial delay

Delay before sampling begins in seconds.


Frequency of sampling in seconds.


Sample window to evaluate.

The number of historic samples to use when determining if the criteria has been met. The window represents a collection of the latest samples gathered. As samples leave the window they are released and will not be used in any future evaluations.

No evaluation will occur until enough samples have been collected to fill the window.


Seconds after sampling begins that it is stopped.

If the sampling has not reached a result and limit's duration has passed since sampling begun, stop the sampling. Limit provides a time constraint on the sampling process.


Criteria to evaluate gathered samples with.


sample execute external

Back to the previous page.