numpy.nancumprod

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

Возвращает кумулятивное произведение элементов массива вдоль заданной оси, обрабатывая не числа с плавающей точкой (NaN) как единицу. Кумулятивное произведение не изменяется при встрече NaN, а ведущие NaN заменяются единицами.

Для срезов, которые состоят только из NaN или пустые, возвращаются единицы.

Введено в версии 1.12.0.

Параметры:

a : array_like Входной массив. axis : int, необязательно Ось, по которой вычисляется кумулятивное произведение. По умолчанию входной массив раскладывается. dtype : dtype, необязательно Тип возвращаемого массива, а также накопителя, в котором элементы умножаются. Если dtype не указан, он по умолчанию устанавливается в тип dtype массива a, за исключением случаев, когда a имеет целочисленный тип с точностью меньше, чем у целочисленного типа по умолчанию для текущей платформы. В таком случае используется целочисленный тип по умолчанию для текущей платформы. out : ndarray, необязательно Альтернативный выходной массив, в котором разместить результат. Он должен иметь такую же форму и длину буфера, как ожидаемый выходной массив, но тип результирующих значений будет преобразован при необходимости.

Возвращаемое значение:

nancumprod : ndarray Новый массив, содержащий результат, возвращается, если не указан out, в противном случае возвращается он.

См. также

numpy.cumprod

Кумулятивное произведение по массиву, распространяющее NaN.

isnan

Показать, какие элементы являются NaN.

Примеры

>>> np.nancumprod(1)
array([1])
>>> np.nancumprod([1])
array([1])
>>> np.nancumprod([1, np.nan])
array([ 1.,  1.])
>>> a = np.array([[1, 2], [3, np.nan]])
>>> np.nancumprod(a)
array([ 1.,  2.,  6.,  6.])
>>> np.nancumprod(a, axis=0)
array([[ 1.,  2.],
       [ 3.,  2.]])
>>> np.nancumprod(a, axis=1)
array([[ 1.,  2.],
       [ 3.,  3.]])