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

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

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

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

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

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

Примеры

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

Создайте символьный вектор. Найдите совокупное произведение его элементов.

syms x
A = (1:5)*x

A =  $(\begin{array}{c} x & 2 x & 3 x & 4 x & 5 x \end{array})$

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

B = cumprod(A)

B =  $(\begin{array}{c} x & 2 x^{2} & 6 x^{3} & 24 x^{4} & 120 x^{5} \end{array})$

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

Создайте 3х3 символьную матрицу A чьими всеми элементами является x.

syms x
A = ones(3)*x

A = 
 $(\begin{array}{c} x & x & x \\ x & x & x \\ x & x & x \end{array})$

Вычислите совокупное произведение элементов A. По умолчанию, cumprod возвращает совокупное произведение каждого столбца.

B = cumprod(A)

B = 
 $(\begin{array}{c} x & x & x \\ x^{2} & x^{2} & x^{2} \\ x^{3} & x^{3} & x^{3} \end{array})$

Чтобы вычислить совокупное произведение каждой строки, установите значение dim опция к 2.

B = cumprod(A,2)

B = 
 $(\begin{array}{c} x & x^{2} & x^{3} \\ x & x^{2} & x^{3} \\ x & x^{2} & x^{3} \end{array})$

Противоположное совокупное произведение 3-D символьного массива

Создайте 3 3 2 символьными массивами.

syms x y
A(:,:,1) = [x y 0; x 3 x*y; x 1/3 y];
A(:,:,2) = [x y 3; 3 x y; y 3 x];
A

A(:,:,1) = 
 $(\begin{array}{c} x & y & 0 \\ x & 3 & x y \\ x & \frac{1}{3} & y \end{array})$

A(:,:,2) = 
 $(\begin{array}{c} x & y & 3 \\ 3 & x & y \\ y & 3 & x \end{array})$

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

B = cumprod(A,2,'reverse')

B(:,:,1) = 
 $(\begin{array}{c} 0 & 0 & 0 \\ 3 x^{2} y & 3 x y & x y \\ \frac{x y}{3} & \frac{y}{3} & y \end{array})$

B(:,:,2) = 
 $(\begin{array}{c} 3 x y & 3 y & 3 \\ 3 x y & x y & y \\ 3 x y & 3 x & x \end{array})$

Чтобы вычислить совокупное произведение вдоль третьего (страница) размерность, задайте dim как 3. Задайте 'reverse' опция, чтобы работать от самой большой страницы индексирует в самый маленький индекс страницы.

B = cumprod(A,3,'reverse')

B(:,:,1) = 
 $(\begin{array}{c} x^{2} & y^{2} & 0 \\ 3 x & 3 x & x y^{2} \\ x y & 1 & x y \end{array})$

B(:,:,2) = 
 $(\begin{array}{c} x & y & 3 \\ 3 & x & y \\ y & 3 & x \end{array})$

Символьный вектор с `NaN` Значения

Создайте символьный вектор, содержащий NaN значения. Вычислите совокупные произведения.

A = [sym('a') sym('b') 1 NaN 2]

A =  $(\begin{array}{c} a & b & 1 & NaN & 2 \end{array})$

B = cumprod(A)

B =  $(\begin{array}{c} a & a b & a b & NaN & NaN \end{array})$

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

B = cumprod(A,'omitnan')

B =  $(\begin{array}{c} a & a b & a b & a b & 2 a b \end{array})$

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

`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 из активной размерности.

Типы данных: char

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

NaN условие в виде:

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

Типы данных: char

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

`B` — Массив совокупного произведения
вектор | матрица | многомерный массив

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

Больше о