Min - chart function

Min() finds the lowest 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 lowest value. By specifying rank as 2, the second lowest value is returned. If rank is 3, the third lowest 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.

By using TOTAL [<fld {.fld}>], where the TOTAL qualifier is followed by a list of one or more field names as a subset of the chart dimension variables, you create a subset of the total possible values.

Defining the aggregation scope

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, which is independent of the selection of Customer B.

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:

LOAD * inline [

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 '|');