Документация

B = cumprod(A) возвращает совокупное произведение A начиная с начала измерения массива в A чей размер не равен 1.

Если A является вектором, тогда cumprod(A) возвращает вектор, содержащий совокупное произведение элементов A.
Если A является матрицей, тогда cumprod(A) возвращает матрицу, содержащую совокупные произведения для каждого столбца A.
Если A является многомерным массивом, затем cumprod(A) действует по первому несинглтону размерности.

B = cumprod(A,dim) возвращает совокупное произведение по размерности dim. Для примера, если A является матрицей, тогда cumprod(A,2) возвращает совокупное произведение каждой строки.

B = cumprod(___,direction) опционально задает направление с помощью любого из предыдущих синтаксисов. Вы должны задать A, и опционально можно задать dim. Для образца, cumprod(A,2,'reverse') возвращает совокупное произведение в строках A путем работы от конца до начала второго измерения.

B = cumprod(___,nanflag) определяет, включать или опускать NaN значения из вычисления для любого из предыдущих синтаксисов. cumprod(A,'includenan') включает NaN значения в вычислении при cumprod(A,'omitnan') игнорирует их.

Примеры

Совокупное произведение вектора

Найдите совокупное произведение целых чисел из 1 на 5. Элемент B(2) является продуктом A(1) и A(2), в то время как B(5) является продуктом элементов A(1) через A(5).

A = 1:5;
B = cumprod(A)

B = 1×5

     1     2     6    24   120

Совокупное произведение каждого столбца в матрице

Задайте матрицу 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 = cumprod(A)

B = 3×3

     1     4     7
     2    20    56
     6   120   504

Совокупное произведение каждой строки в матрице

Задайте матрицу 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 = cumprod(A,2)

B = 2×3

     1     3    15
     2     8    48

Логический вход с двойным выходом

Создайте массив логических значений.

A = [true false true; true true false]

A = 2x3 logical array

   1   0   1
   1   1   0

Найдите совокупное произведение строк A.

B = cumprod(A,2)

B = 2×3

     1     0     0
     1     1     0

У выхода есть тип double.

class(B)

ans = 
'double'

Обратное совокупное произведение

Создайте матрицу 3 на 3 случайных целых чисел между 1 и 10.

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

A = 3×3

     9    10     3
    10     7     6
     2     1    10

Вычислите совокупное произведение вдоль столбцов. Задайте 'reverse' опция для работы снизу вверх в каждом столбце. Результатом является тот же размер, что и A.

B = cumprod(A,'reverse')

B = 3×3

   180    70   180
    20     7    60
     2     1    10

Вектор с `NaN` Значения

Создайте вектор, содержащий NaN значения и вычисление совокупных произведений. По умолчанию cumprod включает NaN значения. Когда вы включаете NaN значений в вычислении, совокупное произведение становится NaN как только первый NaN значение в A встречается.

A = [1 3 NaN 2 4 NaN];
B = cumprod(A)

B = 1×6

     1     3   NaN   NaN   NaN   NaN

Игнорировать NaN значения в вычислении совокупного произведения с помощью 'omitnan' опция.

B = cumprod(A,'omitnan')

B = 1×6

     1     3     3     6    24    24

Входные параметры

`A` - Входной массив
вектор | матрица | многомерный массив

Входной массив, заданный как векторный, матричный или многомерный массив.

`dim` - Размерность для работы
положительный целочисленный скаляр

Размерность для работы, заданная как положительный целочисленный скаляр Если значение не задано, то по умолчанию это первое измерение массива, не равный 1.

Рассмотрим двумерный входной массив, A.

cumprod(A,1) работает над последовательными элементами в столбцах A и возвращает совокупные произведения каждого столбца.
cumprod(A,2) работает над последовательными элементами в строках A и возвращает совокупные произведения каждой строки.

cumprod возвращает A если dim больше ndims(A).

`direction` - Направление кумуляции
`'forward'` (по умолчанию) | `'reverse'`

Направление кумуляции, заданное как 'forward' (по умолчанию) или 'reverse'.

'forward' работает от 1 на end активной размерности.
'reverse' работает от end на 1 активной размерности.

`nanflag` — `NaN` состояние
`'includenan'` (по умолчанию) | `'omitnan'`

NaN условие, заданное как одно из следующих значений:

'includenan' - Включить NaN значения от входов при вычислении каждого продукта, что приводит к NaN значений в выходах.
'omitnan' - Игнорировать NaN значений во входе. Продукт элементов, содержащих NaN значения являются продуктом всех не- NaN элементы. Если все элементы NaN, затем cumprod возвращает 1.

Выходные аргументы

`B` - Совокупный массив продуктов
вектор | матрица | многомерный массив

Совокупное произведение, возвращенный в виде вектора, матрицы или многомерного массива того же размера, что и входной массив A.

Класс B совпадает с классом A кроме тех случаев, когда A является logical, в каком случае B является double.

Подробнее о