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

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 значения являются произведением всех не -NaN элементы. Если все элементы NaN, то cumprod возвращает значение 1.

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

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

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

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

Подробнее