MOVINGMIN

The MOVINGMIN function (abbreviated MVMIN) returns a series of minimum values for the values of a dimensioned variable or expression over a specified dimension. For each dimension value in status, MOVINGMIN searches the data for the minimum value in the range specified, relative to the current dimension value.

When the variable or expression has only the specified dimension, MOVINGMIN produces a single series of minimum values, one for each dimension value in the status. When the variable or expression has dimensions other than the one specified, MOVINGMIN produces a separate series of minimum values for each combination of values in the status list of the other dimensions.

Return Value

DECIMAL

Syntax

MOVINGMIN(expressionstartstopstep, [dimension [STATUS|limit-clause]])

Arguments

expression

A numeric variable or calculation from whose values you want to find the minimum values; for example, UNITS or SALES-EXPENSE.

start

A whole number that specifies the starting point of the range over which you want to search. The range is specified relative to the current value of dimension. Zero (0) refers to the current value, and -1 refers to the value preceding the current value. A comma is required before a negative start number.

Each minimum value is based on data for a specified range of dimension values preceding, including, or following the one for which the minimum value is being returned. To count the values in the range, MOVINGMIN uses the default status, unless you use the STATUS keyword or the limit-clause argument to specify a different dimension status.

stop

A whole number that specifies the ending point of the range over which you want to search. A negative stop number must be preceded by a comma.

step

A positive whole number that specifies whether to search every value in the range, or every other value, or every third value, and so on. A value of 1 for step means search every value. A value of 2 means check the first value, the third value, the fifth value, and so on. For example, when the current month is Jun96 and the start and stop values are -3 and 3, a step value of 2 means search the months Mar96, May96, Jul96 and Sep96 and return the minimum value that occurs in one of those four months.

dimension

The dimension over which the moving minimum is calculated. While this can be any dimension, it is typically a hierarchical time dimension of type TEXT that is limited to a single level (for example, the month or year level) or a dimension with a type of DAY, WEEK, MONTH, Quarter, or YEAR.

When expression has a dimension with a type of DAY, WEEK, MONTH, QUARTER, or YEAR and you want MOVINGMIN to use that dimension, you can omit the dimension argument.

STATUS

Specifies that MOVINGMIN should use the current status list (that is, only the dimension values currently in status in their current status order) when calculating the moving minimum.

limit-clause

Specifies that MOVINGMIN should use the default status limited by limit-clause when calculating the moving minimum.

The syntax of limit-clause is the same syntax as any of the limit-clause arguments in the various forms of the LIMIT command (that is, the syntax of the LIMIT command after the limit-type argument such as "TO"). For the syntax of these arguments, see LIMIT (using values) command, LIMIT using LEVELREL command, LIMIT command (using parent relation), LIMIT (using related dimension) command, LIMIT NOCONVERT command, and LIMIT command (using POSLIST).

To specify that MOVINGMIN should use the current status limited by limit-clause, specify a LIMIT function for limit-clause.

Examples

For an example of calculating minimum sales, see Example 8-31, "Calculating a Moving Average".