numpy.cumprod#

numpy.cumprod(a, axis=None, dtype=None, out=None)[source]#

返回沿給定軸的元素累積乘積。

參數:
aarray_like(類陣列)

輸入陣列。

axisint,選用

計算累積乘積的軸。預設情況下,輸入會被展平。

dtypedtype,選用

返回陣列的類型,以及元素相乘的累加器的類型。如果未指定dtype,則預設為a的dtype,除非a具有整數dtype,其精度低於預設平台整數。在這種情況下,將改用預設平台整數。

outndarray,選用

用於放置結果的替代輸出陣列。它必須具有與預期輸出相同的形狀和緩衝區長度,但必要時會轉換結果值的類型。

返回:
cumprodndarray

除非指定了out,否則會返回一個包含結果的新陣列;如果指定了out,則會返回對 out 的參考。

參見

cumulative_prod

與 Array API 相容的 cumprod 替代方案。

輸出類型判斷

註解

使用整數類型時,算術是模組化的,並且溢位時不會引發錯誤。

範例

>>> import numpy as np
>>> a = np.array([1,2,3])
>>> np.cumprod(a) # intermediate results 1, 1*2
...               # total product 1*2*3 = 6
array([1, 2, 6])
>>> a = np.array([[1, 2, 3], [4, 5, 6]])
>>> np.cumprod(a, dtype=float) # specify type of output
array([   1.,    2.,    6.,   24.,  120.,  720.])

a的每列(即,跨行)的累積乘積

>>> np.cumprod(a, axis=0)
array([[ 1,  2,  3],
       [ 4, 10, 18]])

a的每行(即,跨列)的累積乘積

>>> np.cumprod(a,axis=1)
array([[  1,   2,   6],
       [  4,  20, 120]])