17.4 Суммы и произведения

: y = sum (x) ¶

: y = sum (x, dim) ¶

: y = sum (…, "native") ¶

: y = sum (…, "double") ¶

: y = sum (…, "extra") ¶

Сумма элементов вдоль размерности dim.

Если dim опущено, оно по умолчанию устанавливается для первой несингулярной размерности.

Необязательный "type" вход определяет класс переменной, используемой для вычислений. По умолчанию операции над числами с плавающей запятой (double или single) выполняются в их родном типе данных, а операции над целыми, логическими и символьными типами данных выполняются с использованием doubles. Если аргумент "native" указан, операция выполняется в том же типе, что и исходный аргумент.

Например:

sum ([true, true])
   ⇒ 2
sum ([true, true], "native")
   ⇒ true

Если "double" указано, сумма вычисляется с двойной точностью даже для входных данных с одинарной точностью.

Для входных данных с двойной точностью, опция "extra" будет использовать более точный алгоритм, чем простое суммирование. Для входных данных с одинарной точностью "extra" то же самое, что и "double". Для всех других типов данных "extra" не оказывает влияния.

См. также: cumsum, sumsq, prod.

: y = prod (x) ¶

: y = prod (x, dim) ¶

: y = prod (…, "native") ¶

: y = prod (…, "double") ¶

Произведение элементов вдоль размерности dim.

Если dim опущено, оно по умолчанию устанавливается для первой несингулярной размерности.

Необязательный "type" вход определяет класс переменной, используемой для вычислений. Если аргумент "native" указан, операция выполняется в том же типе, что и исходный аргумент, а не по умолчанию double.

Например:

prod ([true, true])
   ⇒ 1
prod ([true, true], "native")
   ⇒ true

Напротив, если "double" указано, операция выполняется с двойной точностью даже для входных данных с одинарной точностью.

См. также: cumprod, sum.

: y = cumsum (x) ¶

: y = cumsum (x, dim) ¶

: y = cumsum (…, "native") ¶

: y = cumsum (…, "double") ¶

Кумулятивная сумма элементов вдоль размерности dim.

Если dim опущено, оно по умолчанию устанавливается для первой несингулярной размерности. Например:

cumsum ([1, 2; 3, 4; 5, 6])
   ⇒  1   2
       4   6
       9  12

Для объяснения необязательных параметров "native" и "double", см. sum.

См. также: sum, cumprod.

: y = cumprod (x) ¶

: y = cumprod (x, dim) ¶

Кумулятивное произведение элементов вдоль размерности dim.

Если dim опущено, оно по умолчанию устанавливается для первой несингулярной размерности. Например:

cumprod ([1, 2; 3, 4; 5, 6])
   ⇒  1   2
       3   8
      15  48

См. также: prod, cumsum.

: y = sumsq (x) ¶

: y = sumsq (x, dim) ¶

Сумма квадратов элементов вдоль размерности dim.

Если dim опущено, оно по умолчанию устанавливается для первой несингулярной размерности.

Эта функция концептуально эквивалентна вычислению

sum (x .* conj (x), dim)

но она использует меньше памяти и избегает вызова conj если x вещественное.

См. также: sum, prod.