# Min

Min() finds the lowest numeric value of the aggregated data. By specifying a rank n, the nth lowest value can be found.

Tip: You might also want to look at FirstSortedValue and rangemin, which have similar functionality to the Min function.

Syntax:

Min([{SetExpression}] [TOTAL [<fld {,fld}>]] expr [,rank])

Return data type: numeric

Arguments:

Argument Description
expr The expression or field containing the data to be measured.
rank The default value of rank is 1, which corresponds to the highest value. By specifying rank as 2, the second highest value is returned. If rank is 3, the third highest value is returned, and so on.
SetExpression By default, the aggregation function will aggregate over the set of possible records defined by the selection. An alternative set of records can be defined by a set analysis expression.
TOTAL

If the word TOTAL occurs before the function arguments, the calculation is made over all possible values given the current selections, and not just those that pertain to the current dimensional value, that is, it disregards the chart dimensions.

The TOTAL qualifier may be followed by a list of one or more field names within angle brackets <fld>. These field names should be a subset of the chart dimension variables.

Examples and results:

Customer Product UnitSales UnitPrice
Astrida AA 4 16
Astrida AA 10 15
Astrida BB 9 9
Betacab BB 5 10
Betacab CC 2 20
Betacab DD - 25
Canutility AA 8 15
Canutility CC - 19
Note: The Min() function must return a non-NULL value from the array of values given by the expression, if there is one. So in the examples, because there are NULL values in the data, the function returns the first non-NULL value evaluated from the expression.
Examples Results

Min(UnitSales)

2, because this is the lowest non-NULL value in UnitSales.

The value of an order is calculated from the number of units sold in (UnitSales) multiplied by the unit price.

Min(UnitSales*UnitPrice)

40, because this is the lowest non-NULL value result of calculating all possible values of (UnitSales)*(UnitPrice).

Min(UnitSales, 2)

4, which is the second lowest value (after the NULL values).

Min(TOTAL UnitSales)

2, because the TOTAL qualifier means the lowest possible value is found, disregarding the chart dimensions. For a chart with Customer as dimension, the TOTAL qualifier will ensure the minimum value across the full dataset is returned, instead of the minimum UnitSales for each customer.

Make the selection Customer B.

Min({1} TOTAL UnitSales)

40, independent of the selection made, because the Set Analysis expression {1} defines the set of records to be evaluated as ALL, no matter what selection is made.

Data used in examples:

ProductData:

Customer|Product|UnitSales|UnitPrice

Astrida|AA|4|16

Astrida|AA|10|15

Astrida|BB|9|9

Betacab|BB|5|10

Betacab|CC|2|20

Betacab|DD||25

Canutility|AA|8|15

Canutility|CC||19

] (delimiter is '|');