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

: y = sum (x)

: y = sum (x, dim)

: y = sum (…, "native")

: y = sum (…, "double")

: y = sum (…, "extra")

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

Если dim не указана, по умолчанию используется первая размерность, размер которой не равен 1.

Необязательный входной аргумент "type" определяет класс переменной, используемой для вычислений. По умолчанию операции с входными данными с плавающей точкой (double или single) выполняются в исходном типе данных, а операции с целочисленными, логическими и символьными типами данных выполняются с использованием double. Если указан аргумент "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 не указана, по умолчанию используется первая размерность, размер которой не равен 1.

Необязательный входной аргумент "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 не указана, по умолчанию используется первая размерность, размер которой не равен 1. Например:

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 не указана, по умолчанию используется первая размерность, размер которой не равен 1. Например:

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

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

: y = sumsq (x)

: y = sumsq (x, dim)

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

Если dim не указана, по умолчанию используется первая размерность, размер которой не равен 1.

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

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

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

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