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

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.

Подробнее о