Successively adds the current row to the previous row
Purpose
Use this function to:
- Sum information gathered over time
- Show how sales have increased since the beginning of the year
- Calculate “how much so far”
Calculation
cumul(RowX)= rowX + cumul(X-1)
RowX = value for current row
cumul(X-1) = row(X-1) + cumul(X-2)Sample Result
Parameters
| Parameter | Description |
|---|---|
| Dimensions | Discrete field(s). All fields must come from the same table. |
| Name | Name to be displayed as Column Header in result grid |
| Measure | The field to be used in the post-function calculation.
|
| Function | COUNT / SUM / AVG / MIN / MAX / STDEV |
| Post | cumul |
| Value | Optional. Filter to apply when evaluating FUNCTION. Only records in the Filter Recordset will be included in the Function and Post-Function calculations. Must come from same table as DIMENSION/MEASURE or be linked to the Dimension table. |
| Axis | 0 / 1. Y-Axis to use when plotting graph. Default = 0 |
| Plot | Y / N. Specifies whether measure’s output column should be plotted on graph. Default = Y |
| Resolve | Optional. Resolve level for the measure. If blank, Resolve = Dimension Table |
| Series Type | Default / Bar / Stacked Bar / Line / Spline / RangeLow / RangeHigh / CSLow / CSHigh / CSOpen / CSClose Determines the graph style for the measure. |
| Popup | Default / None / Extended |
| Prefix | $ / £ / E / % |
Usage Notes
Cumul is affected by the order in which rows are returned from the engine. Look at Ascending / Descending, Label / Value to control the way in which data is accumulated.
Example
NOTE: Measure 1 is included purely for illustration. It is not necessary to include this measure for the calculation to work.
Dimension (s): [transactions].[product_group], [transactions].[yearmonth]
Measure 1
Name: =Sales
- Measure: = transactions.castprice
- Function: = sum
- Post: =
- Value: =
- Axis: =0
- Plot:=Y
- Resolve:=
- Series Type:= Bar
- Popup:=Default
- Prefix:=
Measure 2
- Name: =Sales To Date
- Measure: = transactions.castprice
- Function: = sum
- Post: = cumul
- Value: =
- Axis: =0
- Plot:=Y
- Resolve:=
- Series Type:= Line
- Popup:=Default
- Prefix:=
Example use: Calculate sales to date
Running Total of sales. Adds each month’s sales figure to the sum of all the months before it.
