Skip to main content Skip to complementary content

Mode - chart function

Mode() finds the most commonly-occurring value, the mode value, in the aggregated data. The Mode() function can process text values as well as numeric values.


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

Return data type: dual


Argument Description
expr The expression or field containing the data to be measured.
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.

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
Examples and results
Examples Results


Make the selection Customer A.

15, because this is the most commonly-occurring value in UnitSales.

Returns NULL (-). No single value occurs more often than another.


Make the selection Customer A

AA, because this is the most commonly occurring value in Product.

Returns NULL (-). No single value occurs more often than another.

Mode(TOTAL UnitPrice)

15, because the TOTAL qualifier means the most commonly occurring value is still 15, even disregarding the chart dimensions.

Make the selection Customer B.

Mode({1} TOTAL UnitPrice)

15, 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:


LOAD * inline [










] (delimiter is '|');

Did this page help you?

If you find any issues with this page or its content – a typo, a missing step, or a technical error – let us know how we can improve!