SETRANGES sets up ranges in one domain according to value ranges in a parallel domain.
It is best understood by an example of its use,
value object: 3,5,8,6,0,0,3,4,7,2
range object: 1,2,3,4,5,6,7,8,9,10
Limits: 4,7
resulting in range values 2,2,4,4,8,9.
The resulting vector of ranges is written to the global RANGES parameter from where it can be picked up by, for example, BINSUBSET.
In practice SETRANGES might be used on a time series to find all the values of time (the range object) when the counts (the value object) fall within certain limits (the LIMITS).
Another example is that one could find all the times when Quality is set to any given value or range of values (LIMITS).
NOTE: The value limits specified are inclusive (see
example above). It is therefore possible to
select slices where the free parameter has a
single value rather than a range of value by
entering the same value as both upper and lower
limit of LIMITS.