`<cumulativeSum>`

Running total of the child math or number values: the list of partial sumsAdded in 0.7.27

<cumulativeSum> is a Math Operator component that renders the running total of its arguments: a list whose $n$ th entry is the sum of the first $n$ 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.

Number display (5)

avoidScientificNotation

boolean. Default value: false. Whether to render numbers in full decimal form rather than scientific notation.

displayDecimals

integer. Default value: 2. Number of decimal places to display when rendering this number.

displayDigits

integer. Default value: 3. Number of significant digits to display when rendering this number.

displaySmallAsZero

number. Default value: 1e-14. Threshold below which numbers are displayed as zero.

padZeros

boolean. Default value: false. 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

boolean. 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.

Number display (5)

$c.avoidScientificNotationIn development

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

$c.displayDecimalsIn development

integer. Number of decimal places to display when rendering this number.

$c.displayDigitsIn development

integer. Number of significant digits to display when rendering this number.

$c.displaySmallAsZeroIn development

number. Threshold below which numbers are displayed as zero.

$c.padZerosIn development

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

Common to all components (8)

$c.disabledIn development

boolean. Whether this component is disabled and cannot be interacted with.

$c.doenetML

text. The DoenetML source code that produced this component.

$c.fixedIn development

boolean. Whether this component's value is fixed and cannot be modified.

$c.fixLocationIn development

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

$c.hiddenIn development

boolean. Whether this component is hidden from the rendered output.

$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 $x$ , $x+y$ , $x+y+z$ .

<cumulativeSum>