# Count - chart function

Count() is used to aggregate the number of values, text and numeric, in each chart dimension.

Syntax:

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

Return data type: integer

Arguments:

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.
DISTINCT If the word DISTINCT occurs before the function arguments, duplicates resulting from the evaluation of the function arguments are disregarded.
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.

Examples and results:

Customer Product OrderNumber UnitSales Unit Price
Astrida AA 1 4 16
Astrida AA 7 10 15
Astrida BB 4 9 9
Betacab BB 6 5 10
Betacab CC 5 2 20
Betacab DD 1 25 25
Canutility AA 3 8 15
Canutility CC     19

The following examples assume that all customers are selected, except where stated.

Example Result
Count(OrderNumber)

10, because there are 10 fields that could have a value for OrderNumber, and all records, even empty ones, are counted.

Note: "0" counts as a value and not an empty cell. However, if a measure aggregates to 0 for a dimension, that dimension will not be included in charts.
Count(Customer) 10, because Count evaluates the number of occurrences in all fields.
Count(DISTINCT [Customer]) 4, because using the Distinct qualifier, Count only evaluates unique occurrences.

Given that customer Canutility is selected

Count(OrderNumber)/Count({1} TOTAL OrderNumber)

0.2, because the expression returns the number of orders from the selected customer as a percentage of orders from all customers. In this case 2 / 10.

Given that customers Astrida and Canutility are selected

Count(TOTAL <Product> OrderNumber)

5, because that is the number of orders placed on products for the selected customers only and empty cells are counted.

Data used in examples:

Temp:

Customer|Product|OrderNumber|UnitSales|UnitPrice

Astrida|AA|1|4|16

Astrida|AA|7|10|15

Astrida|BB|4|9|9

Betacab|CC|6|5|10

Betacab|AA|5|2|20

Betacab|BB|1|25| 25

Canutility|AA|3|8|15

Canutility|CC|||19