Main Content

cumsum

累积和

说明

示例

B = cumsum(A)A 中的第一个其大小大于 1 的数组维度开始返回 A 的累积和。

  • 如果 A 是向量,则 B 是相同大小的向量,包含 A 的累积和。

  • 如果 A 是矩阵,则 B 是同样大小的矩阵,包含 A 的每列的累积和。

  • 如果 A 是多维数组,则 B 是相同大小的数组,包含沿 A 的大小大于 1 的第一个数组维度的累积和。

  • 如果 A 是表或时间表,则 M 是相同大小的表或时间表,包含 A 的每个变量中的累积和。 (自 R2023a 起)

B 的类与 A 的类相同,但 Alogical 除外(这种情况下 Bdouble)。

示例

B = cumsum(A,dim) 返回沿维度 dim 的元素的累积和。例如,如果 A 是矩阵,则 cumsum(A,2) 沿 A 的各行返回累积和。

示例

B = cumsum(___,direction) 可在上述任一语法的基础上指定计算方向。例如,cumsum(A,2,"reverse") 通过从尾到头计算 A 的第二个维度返回其中各行的累积和。

示例

B = cumsum(___,nanflag) 指定包含还是省略 A 中的 NaN 值。例如,cumsum(A,"omitnan") 在计算每个和时忽略 NaN 值。默认情况下,cumsum 包括 NaN 值。

示例

全部折叠

计算从 15 的整数的累积和。元素 B(2)A(1)A(2) 的和,而 B(5) 是元素 A(1)A(5) 的和。

A = 1:5;
B = cumsum(A)
B = 1×5

     1     3     6    10    15

创建一个元素与其线性索引对应的 3×3 矩阵。

A = [1 4 7; 2 5 8; 3 6 9]
A = 3×3

     1     4     7
     2     5     8
     3     6     9

计算 A 的列的累积和。元素 B(5)A(4)A(5) 的和,而 B(9)A(7)A(8)A(9) 的和。

B = cumsum(A)
B = 3×3

     1     4     7
     3     9    15
     6    15    24

定义其元素与其线性索引对应的 2×3 矩阵。

A = [1 3 5; 2 4 6]
A = 2×3

     1     3     5
     2     4     6

计算 A 的行的累积和。元素 B(3)A(1)A(3) 的和,而 B(5)A(1)A(3)A(5) 的和。

B = cumsum(A,2)
B = 2×3

     1     4     9
     2     6    12

创建一个逻辑值数组。

A = [true false true; true true false]
A = 2x3 logical array

   1   0   1
   1   1   0

计算 A 的行的累积和。

B = cumsum(A,2)
B = 2×3

     1     1     2
     1     2     2

输出的类型为 double

class(B)
ans = 
'double'

创建一个包含介于 1 到 10 的随机整数的 3×3 的矩阵。

rng default;
A = randi([1,10],3)
A = 3×3

     9    10     3
    10     7     6
     2     1    10

沿各行计算累积和。指定 "reverse" 选项在各行中从右向左运行。结果的大小与 A 相同。

B = cumsum(A,2,"reverse")
B = 3×3

    22    13     3
    23    13     6
    13    11    10

创建一个包含 NaN 值的矩阵。

A = [3 5 NaN 4; 2 6 NaN 9; 1 3 5 NaN]
A = 3×4

     3     5   NaN     4
     2     6   NaN     9
     1     3     5   NaN

计算矩阵的累积和,不包括 NaN 值。对于包含前导 NaN 值的矩阵列,累积和为 0,直到遇到非 NaN 值。

B = cumsum(A,"omitnan")
B = 3×4

     3     5     0     4
     5    11     0    13
     6    14     5    13

输入参数

全部折叠

输入数组,指定为向量、矩阵、多维数组、表或时间表。

数据类型: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | duration | table | timetable
复数支持:

沿其运算的维度,指定为正整数标量。如果不指定维度,则默认为第一个大于 1 的数组维度。

以一个二维输入数组 A 为例:

  • cumsum(A,1)A 的列中的连续元素进行求和并返回一个包含每列累积和的行向量。

  • cumsum(A,2)A 的行中的连续元素进行求和并返回一个包含每行累积和的列向量。

cumsum(A,1) column-wise operation and cumsum(A,2) row-wise operation

如果 dim 大于 ndims(A),则 cumsum 返回 A

累积方向,指定为以下值之一:

  • "forward" - 从运算维度的 1end 运算。

  • "reverse" - 从运算维度的 end1 运算。

缺失值条件,指定为下列值之一:

  • "includemissing""includenan" - 在计算累积和时包括 A 中的 NaN 值。只要在 A 中遇到第一个 NaN 值,B 中的元素就立即成为 NaN"includemissing""includenan" 具有相同的行为。

  • "omitmissing""omitnan" - 在计算累积和时忽略 A 中的 NaN 值。如果 A 具有连续前导 NaN 值,则 B 中对应的元素为 0。"omitmissing""omitnan" 具有相同的行为。

提示

  • 利用许多累积函数中的 "reverse" 选项可以快速执行定向计算,而不需要翻转或反射输入数组。

扩展功能

版本历史记录

在 R2006a 之前推出

全部展开

另请参阅

| | | | | |