ReferencecumulativeSum

<cumulativeSum>

Running total of the child math or number values: the list of partial sums

<cumulativeSum> is a Math Operator component that renders the running total of its arguments: a list whose nnth entry is the sum of the first nn input values.

Where <sum> reduces a list to a single value, <cumulativeSum> produces a list the same length as its input.

Attributes and Properties

Attributes for <cumulativeSum>

Highlighted (3)
asList

boolean. Default value: true. Whether to render the items separated by commas (true) or with no separator (false).

forceNumeric

boolean. Default value: false. Whether to force the operator to evaluate numerically rather than symbolically.

forceSymbolic

boolean. Default value: false. Whether to force the operator to evaluate symbolically rather than numerically.

Other (5)
avoidScientificNotation

Whether to render numbers in full decimal form rather than scientific notation.

displayDecimals

Number of decimal places to display when rendering this number.

displayDigits

Number of significant digits to display when rendering this number.

displaySmallAsZero

Threshold below which numbers are displayed as zero.

padZeros

Whether to pad displayed numbers with trailing zeros to fill the requested digits/decimals.

Common to all components (9)
copy

reference. Create an independent copy of another component by reference. Enter a references a $name.

disabled

boolean. Default value: false. Whether this component is disabled and cannot be interacted with.

extend

reference. Extend another component by reference, inheriting its children and attributes. Enter a reference as $name.

fixed

Default value: false. Whether this component's value is fixed and cannot be modified.

fixLocation

boolean. Default value: false. Whether this component's location is fixed (preventing it from being moved while still allowing other modifications).

hide

boolean. Default value: false. Whether to hide this component from the rendered output.

isResponse

boolean. Default value: false. Whether this component is treated as a response for the purposes of assessment.

name

text. The name used to reference this component from elsewhere in the document.

styleNumber

integer. Default value: 1. The style number used to select this component's visual styling from the available style definitions.

Properties for <cumulativeSum name="c">

Highlighted (2)
$c.forceNumeric

boolean. Whether to force the operator to evaluate numerically rather than symbolically.

$c.forceSymbolic

boolean. Whether to force the operator to evaluate symbolically rather than numerically.

Common to all components (4)
$c.doenetML

text. The DoenetML source code that produced this component.

$c.hide

boolean. Whether to hide this component from the rendered output.

$c.isResponse

boolean. Whether this component is treated as a response for the purposes of assessment.

$c.styleNumber

integer. The style number used to select this component's visual styling from the available style definitions.

Examples

Example: <cumulativeSum> of a list of numbers

Each entry is the total of everything up to and including it, so the last entry equals the <sum> of the whole list.


Example: indexing into the result

The result behaves like any other list: individual entries are available with $cum[3], and the whole thing can be passed on to another operator.


Example: partial sums of a series

Rounding attributes such as displayDigits are passed through to every value in the result.


Example: symbolic partial sums

When the inputs are not all numbers, <cumulativeSum> accumulates symbolically, giving xx, x+yx+y, x+y+zx+y+z.