CumSum#
Versioned name: CumSum-3
Category: Arithmetic unary
Short description: CumSum performs cumulative summation of the input elements along the given axis.
Detailed description: CumSum performs cumulative summation of the input elements along the axis
specified by the second input. By default, the j-th
output element is the inclusive sum of the first j
elements in the given sequence, and the first element in the sequence is copied to the output as is.
In the exclusive
mode the j-th
output element is the sum of the first j-1
elements and the first element in the output sequence is 0
.
To perform the summation in the opposite direction of the axis, set reverse attribute to true
.
Attributes:
exclusive
Description: If the attribute is set to
true
, then exclusive sums are returned, thej-th
element is not included in thej-th
sum. Otherwise, the inclusive sum of the firstj
elements for thej-th
element is calculated.Range of values:
false
- include the top elementtrue
- do not include the top element
Type:
boolean
Default value:
false
Required: no
reverse
Description: If set to
true
will perform the sums in reverse direction.Range of values:
false
- do not perform sums in reverse directiontrue
- perform sums in reverse direction
Type:
boolean
Default value:
false
Required: no
Inputs
1: A tensor of type T and rank greater or equal to 1. Required.
2: Axis index along which the cumulative sum is performed. A scalar of type T_AXIS. Negative value means counting dimensions from the back. Default value is
0
. Optional.
Outputs
1: Output tensor with cumulative sums of the input elements. A tensor of type T of the same shape as the first input.
Types
T: any numeric type.
T_AXIS:
int64
orint32
.
Examples
Example 1
<layer ... type="CumSum" exclusive="0" reverse="0">
<input>
<port id="0"> <!-- input value is: [1., 2., 3., 4., 5.] -->
<dim>5</dim>
</port>
<port id="1"/> <!-- axis value is: 0 -->
</input>
<output>
<port id="2"> <!-- output value is: [1., 3., 6., 10., 15.] -->
<dim>5</dim>
</port>
</output>
</layer>
Example 2
<layer ... type="CumSum" exclusive="1" reverse="0">
<input>
<port id="0"> <!-- input value is: [1., 2., 3., 4., 5.] -->
<dim>5</dim>
</port>
<port id="1"/> <!-- axis value is: 0 -->
</input>
<output>
<port id="2"> <!-- output value is: [0., 1., 3., 6., 10.] -->
<dim>5</dim>
</port>
</output>
</layer>
Example 3
<layer ... type="CumSum" exclusive="0" reverse="1">
<input>
<port id="0"> <!-- input value is: [1., 2., 3., 4., 5.] -->
<dim>5</dim>
</port>
<port id="1"/> <!-- axis value is: 0 -->
</input>
<output>
<port id="2"> <!-- output value is: [15., 14., 12., 9., 5.] -->
<dim>5</dim>
</port>
</output>
</layer>
Example 4
<layer ... type="CumSum" exclusive="1" reverse="1">
<input>
<port id="0"> < -- input value is: [1., 2., 3., 4., 5.] -->
<dim>5</dim>
</port>
<port id="1"/> < -- axis value is: 0 -->
</input>
<output>
<port id="2"> < -- output value is: [14., 12., 9., 5., 0.] -->
<dim>5</dim>
</port>
</output>
</layer>