---

17.4和和积¶

 

y = sum (x) ¶

y = sum (x, dim) ¶

y = sum (x, vecdim) ¶

y = sum (x, "all") ¶

y = sum (…, outtype) ¶

y = sum (…, nanflag) ¶

计算x的元素之和。

如果x是一个向量，则sum (x)返回x中元素的和。

如果x是一个矩阵，那么sum (x) 返回一个行向量，其中每个元素包含x中相应列的和。

如果x是一个数组，则sum (x) 沿着x的第一个非奇异维度求和。

可选输入参数dim指定要操作的维度，必须是正整数。 如果在x中指定任何奇异维度，包括任何超过ndims (x)的维度, 将返回 x.

用vecdim指定多个维度，一个由不重复的维度组成的向量，这将沿着由vecdim定义的数组切片进行操作。 如果vecdim索引了x的所有维度，那么它等同于选项"all". 任何在vecdim中大于ndims (x)的维度都被忽略。

指定维度为"all"将导致sum 对x的所有元素求和，等效于cumsum (x(:)).

可选输入参数outtype 指定了数据类型，该类型将作为返回的类型以及用于计算的数据类型。 outtype支持的类型如下：

"default"

在浮点数输入(double or single)的操作上，使用其原生数据类型进行操作，而对于整数、逻辑和字符数据的操作则使用双精度。 输出类型为双精度。除非输入是单精度，此时输出为单精度。

"double"

使用双精度进行操作，即便输入是单精度。输出为双精度。

"extra"

对于双精度输入，sum将使用比简单求和更精确的算法。对于单精度输入， "extra"和"double"相同。对于所有其他数据类型， "extra"没有影响。

"native"

操作使用输入变量的原生数据类型，输出的类型与输入相同，由(class (x))报告. 如果输入是逻辑类型，则sum (x, "native")等效于 any (x).

可选变量nanflag指定是否使用任何先前指定的输入参数组合来包含或排除计算中的NaN值。 默认的nanflag值为 "includenan"， 保留NaN值在计算中。要排除NaN值，请将nanflag的值设置为 "omitnan". 如果x在操作维度上的所有值都是NaN，则输出0。

详见: cumsum,sumsq,prod.

 

y = prod (x) ¶

y = prod (x, dim) ¶

y = prod (x, vecdim) ¶

y = prod (x, "all") ¶

y = prod (…, outtype) ¶

y = prod (…, nanflag) ¶

计算x中元素的乘积。

如果x是一个向量，则prod (x)返回x中元素的乘积。

如果x是一个矩阵，那么prod (x) 返回一个行向量，其中每个元素是x中相应列的乘积。

如果x是一个数组，则prod (x) 沿着x的第一个非奇异维度求积。

可选输入参数dim指定要操作的维度，必须是正整数。 指定x中的任何奇异维度，包括超过ndims (x)的维度，将返回x.

用vecdim指定多个维度，一个由不重复的维度组成的向量，这将沿着由vecdim定义的数组切片进行操作。 如果vecdim索引了x的所有维度，那么它等同于选项"all". 任何在vecdim中大于ndims (x)的维度将被忽略。

指定维度为"all"将导致prod 对x的所有元素求积，等效于prod (x(:)).

可选输入参数outtype指定了数据类型，该类型将作为返回的类型以及用于计算的数据类型。 outtype支持如下选项：

"default"

在浮点数输入(double or single)的操作上，使用其原生数据类型进行操作，而对于整数、逻辑和字符数据的操作则使用双精度。 输出类型为双精度。除非输入是单精度，此时输出为单精度。

"double"

使用双精度进行操作，即便输入是单精度。输出为双精度。

"native"

操作使用输入变量的原生数据类型，输出的类型与输入相同，由(class (x))报告. 如果输入是逻辑类型，则prod (x, "native")等效于 all (x).

可选变量nanflag指定是否使用任何先前指定的输入参数组合来包含或排除计算中的NaN值。 默认的nanflag值为 "includenan"， 保留NaN值在计算中。要排除NaN值，请将nanflag的值设置为 "omitnan". 如果x在操作维度上的所有值都是NaN，则输出1。

详见: cumprod,sum.

 

y = cumsum (x) ¶

y = cumsum (x, dim) ¶

y = cumsum (x, vecdim) ¶

y = cumsum (…, "all") ¶

y = cumsum (…, direction) ¶

y = cumsum (…, nanflag) ¶

计算x中元素的累加和。

如果x是一个向量，则cumsum (x) 返回一个向量，其大小与x相同，其中包含累加和。

如果x是一个矩阵，那么cumsum (x) 返回一个矩阵，其大小与x相同，其中包含沿列方向的累加和。

如果x是一个数组，则cumsum (x) 返回沿着x的第一个非奇异维度的累加和。

输出y的类型与x的类型相同，除非x是逻辑类型，此时y为双精度。

可选输入参数dim指定了要操作的维度，必须是正整数。 指定x中的任何奇异维度，包括超过ndims (x)的维度，将返回x.

用vecdim指定多个维度，一个由不重复的维度组成的向量，这将沿着由vecdim定义的数组切片进行操作。 如果vecdim索引了x的所有维度，那么它等同于选项"all". 任何在vecdim中大于ndims (x)的维度将被忽略。

指定维度为"all"将导致cumsum对x的所有元素求和，等效于 cumsum (x(:)).

可选输入参数direction指定了操作维度是如何遍历的，可以取以下值：

"forward" (default)

累加和从开始（索引1）到结束，沿着操作维度计算。

"reverse"

累加和从结束到开始，沿着操作维度计算。

可选变量nanflag指定是否使用任何先前指定的输入参数组合来包含或排除计算中的NaN值。 默认的nanflag值为 "includenan"， 保留NaN值在计算中。要排除NaN值，请将nanflag的值设置为 "omitnan". 如果x在操作维度上的所有值都是NaN，则输出仍然保留NaN值。

详见: sum,cumprod.

 

y = cumprod (x) ¶

y = cumprod (x, vecdim) ¶

y = cumprod (…, "all") ¶

y = cumprod (…, direction) ¶

y = cumprod (…, nanflag) ¶

计算x中元素的累乘积。

如果x是一个向量，则cumprod (x) 返回一个向量，其大小与x相同，其中包含累乘积。

如果x是一个矩阵，那么cumprod (x) 返回一个矩阵，其大小与x相同，其中包含沿列方向的累乘积。

如果x是一个数组，则cumprod (x) 返回沿着x的第一个非奇异维度的累乘积。

输出y的类型与x的类型相同，除非x是逻辑类型，此时y为双精度。

可选输入参数dim指定了要操作的维度，必须是正整数。 指定x中的任何奇异维度，包括超过ndims (x)的维度，将返回x.

用vecdim指定多个维度，一个由不重复的维度组成的向量，这将沿着由vecdim定义的数组切片进行操作。 如果vecdim索引了x的所有维度，那么它等同于选项"all". 任何在vecdim中大于ndims (x)的维度将被忽略。

指定维度为"all"将导致cumprod对x的所有元素求积，等效于 cumprod (x(:)).

可选输入参数direction指定了操作维度是如何遍历的，可以取以下值：

"forward" (default)

累乘积从开始（索引1）到结束，沿着操作维度计算。

"reverse"

累乘积从结束到开始，沿着操作维度计算。

可选变量nanflag指定是否使用任何先前指定的输入参数组合来包含或排除计算中的NaN值。 默认的nanflag值为 "includenan"， 保留NaN值在计算中。要排除NaN值，请将nanflag的值设置为 "omitnan". 如果x在操作维度上的所有值都是NaN，则输出仍然保留NaN值。

详见: prod,cumsum.

 

y = sumsq (x) ¶

y = sumsq (x, vecdim) ¶

y = sumsq (x, "all") ¶

y = sumsq (…, outtype) ¶

y = sumsq (…, nanflag) ¶

计算x中元素的平方和。

如果x是一个向量，则sumsq (x)返回x中所有元素的平方和。

如果x是一个矩阵，则sumsq (x)返回一个行向量，其中包含x中相应列的平方和。

如果x是一个矩阵，则sumsq (x)沿着x的第一个非奇异维度计算平方和。

这里的函数在概念上等同于计算

sum (x .* conj (x))

但它使用较少的内存并避免调用conj如果x是实数的。

可选输入参数dim指定了要操作的维度，必须是正整数。 指定x中的任何奇异维度，包括超过ndims (x)的维度，将返回 等于x.^2的平方和.

用vecdim指定多个维度，一个由不重复的维度组成的向量，这将沿着由vecdim定义的数组切片进行操作。 如果vecdim索引了x的所有维度，那么它等同于选项"all". 任何在vecdim中大于ndims (x)的维度将被忽略。

指定维度为"all"将导致prod对所有x的元素操作，等效于 sumsq (x(:)).

可选输入参数outtype指定了数据类型，该类型将作为返回的类型以及用于计算的数据类型。 outtype支持如下选项：

"default"

在浮点数输入(double or single)的操作上，使用其原生数据类型进行操作，而对于整数、逻辑和字符数据的操作则使用双精度。 输出类型为双精度。除非输入是单精度，此时输出为单精度。

"double"

使用双精度进行操作，即便输入是单精度。输出为双精度。

"native"

操作使用输入变量的原生数据类型，输出的类型与输入相同，由(class (x))报告. 如果输入是逻辑类型，则sumsq (x, "native")等效于 all (x).

可选变量nanflag指定是否使用任何先前指定的输入参数组合来包含或排除计算中的NaN值。 默认的nanflag值为 "includenan"， 保留NaN值在计算中。要排除NaN值，请将nanflag的值设置为 "omitnan". 如果x在操作维度上的所有值都是NaN，则输出0。

详见: sum,prod.