sum

语法

sum(X)

详情

  • 若 X 为向量，返回 X 中所有元素之和。

  • 若 X 为矩阵，计算每列元素之和，返回一个向量。

  • 若 X 为表，计算每列元素之和，返回一个表。

与所有其它聚合函数一致，计算时忽略 NULL 值。

如果 X 中的所有元素为 NULL，sum 返回的结果为 NULL。

注：

DolphinDB sum、numpy.sum 和 Python 内置 sum 都用于求和。区别如下：

  • DolphinDB sum 是聚合函数，支持标量、向量、矩阵和表，矩阵和表按列求和，并忽略 NULL。
  • numpy.sum 是数组归约函数，默认对所有元素求和，可通过 axis 指定维度，并支持 dtype、out、keepdims、initial、where 等参数。
  • Python 内置 sum 只是对可迭代对象从左到右累加，不支持轴向计算，也不会自动忽略缺失值。

DolphinDB 的 sum 是聚合求和，而 TA-Lib 的 SUM 是滚动求和。二者虽同名但语义完全不同，在 DolphinDB 中实现滚动求和，应使用 msum 而非 sum。

参数

X 可以是标量、向量、矩阵或表。

返回值

返回标量、向量或表。

例子

sum(1 2 3 NULL 4);
// output
10

m=matrix(1 2 3, 4 5 6);
m;
#0 #1
1 4
2 5
3 6 
sum(m);
// output
[6,15]