pandas.Series.cumprod#

Series.cumprod(axis=0, skipna=True, *args, **kwargs)[source]#

Return cumulative product over a Series.

Returns a Series of the same size containing the cumulative product.

Parameters:
axis{0 or ‘index’}, default 0

This parameter is unused and defaults to 0.

skipnabool, default True

Exclude NA/null values. If entire Series is NA, the result will be NA.

*args, **kwargs

Additional keywords have no effect but might be accepted for compatibility with NumPy. See NumPy compatibility kwargs for more.

Returns:
Series

Return cumulative product of Series.

See also

Series.prod

Return the product over Series.

Series.cummax

Return cumulative maximum.

Series.cummin

Return cumulative minimum.

Series.cumsum

Return cumulative sum.

Examples

>>> s = pd.Series([2, np.nan, 5, -1, 0])
>>> s
0    2.0
1    NaN
2    5.0
3   -1.0
4    0.0
dtype: float64

By default, NA values are ignored.

>>> s.cumprod()
0     2.0
1     NaN
2    10.0
3   -10.0
4    -0.0
dtype: float64

To include NA values in the operation, use skipna=False

>>> s.cumprod(skipna=False)
0    2.0
1    NaN
2    NaN
3    NaN
4    NaN
dtype: float64