.. highlightlang:: us

.. index:: cumprod

.. _cumprod:

cumprod
========

.. us.tag  cumprod ENGLISH math-base New5800

:ref:`cumprod` returns the cumulative product of each column of a matrix.

.. function::  rmCumprod = cumprod(rmMat)

.. us.return

**Return Value**

*rmCumprod* is a real matrix with cumulative products.

.. us.params

**Parameters**

.. uparam:: r

   *r* is a real matrix.

.. us.example

**Example**

::

   a = [1,2,3;
        4,5,6;
        7,8,9]
   cumprod(a)
    1.0000     2.0000     3.0000 
    4.0000    10.0000    18.0000 
   28.0000    80.0000   162.0000 

.. us.history

**History**

.. list-table::
   :header-rows: 1

   * - Version
     - Description
   * - R2016
     - New.

.. seealso::
   :ref:`overview-mathematic`,
   :ref:`diff`,
   :ref:`cumsum`

:sub:`id-2100504`