Contents x
      cumul
      • 1 Minute to read
      • Print
      • Dark
        Light
      • PDF
      Contents

      cumul

      • 1 Minute to read
      • Print
      • Dark
        Light
      • PDF
      Article summary

      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

      ParameterDescription
      DimensionsDiscrete field(s).    All fields must come from the same table.
      NameName to be displayed as Column Header in result grid
      Measure

      The field to be used in the post-function calculation.

      • Must be numeric if Function is anything other than COUNT.
      • Must come from same table as DIMENSIONS.
      • Supports Discrete or Continuous DataTypes.
      FunctionCOUNT / SUM / AVG / MIN / MAX / STDEV
      Postcumul
      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.

      Axis0 / 1.    Y-Axis to use when plotting graph.     Default = 0
      PlotY / N.   Specifies whether measure’s output column should be plotted on graph.  Default = Y
      ResolveOptional.   Resolve level for the measure.   If blank, Resolve = Dimension Table
      Series TypeDefault / Bar / Stacked Bar / Line / Spline / RangeLow / RangeHigh / CSLow / CSHigh / CSOpen / CSClose
      Determines the graph style for the measure.
      PopupDefault / 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.


      Was this article helpful?
      What's Next