pandas.Series.cumprod

Series.cumprod(axis=0, skipna=True, *args, **kwargs)

返回 DataFrame 或 Series 轴上的累积乘积。

返回一个与原数据相同大小的 DataFrame 或 Series，包含累积乘积。

参数:

轴{0 或 ‘index’, 1 或 ‘columns’}，默认 0

索引或轴的名称。0 等同于 None 或 ‘index’。对于 Series，此参数未使用并默认为 0。

skipna布尔值, 默认为 True

排除 NA/null 值。如果整行/整列都是 NA，结果将是 NA。

*args, **kwargs

额外的关键字没有效果，但可能被接受以兼容NumPy。

返回:

标量或序列

返回标量或系列的累积乘积。

参见

core.window.expanding.Expanding.prod

类似的功能，但忽略 NaN 值。

Series.prod

返回沿 Series 轴的乘积。

Series.cummax

返回沿 Series 轴的累积最大值。

Series.cummin

返回沿 Series 轴的累积最小值。

Series.cumsum

返回沿 Series 轴的累积和。

Series.cumprod

返回沿 Series 轴的累积乘积。

例子

系列

>>> 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

默认情况下，NA 值会被忽略。

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

要在操作中包含 NA 值，请使用 skipna=False

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

DataFrame

>>> df = pd.DataFrame([[2.0, 1.0],
...                    [3.0, np.nan],
...                    [1.0, 0.0]],
...                   columns=list('AB'))
>>> df
     A    B
0  2.0  1.0
1  3.0  NaN
2  1.0  0.0

默认情况下，遍历行并在每一列中找到乘积。这等同于 axis=None 或 axis='index'。

>>> df.cumprod()
     A    B
0  2.0  1.0
1  6.0  NaN
2  6.0  0.0

要遍历列并在每一行中找到乘积，请使用 axis=1

>>> df.cumprod(axis=1)
     A    B
0  2.0  2.0
1  3.0  NaN
2  1.0  0.0