numpy.nancumprod

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

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

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

Новая в версии 1.12.0.

Параметры

aarray_like

Вводной массив.

axisint, optional

Ось, по которой вычисляется кумулятивное произведение. По умолчанию входной массив сжимается.

dtypedtype, optional

Тип возвращаемого массива, а также аккумулятора, в котором выполняются умножения элементов. Если dtype не указан, он по умолчанию устанавливается в тип данных a, за исключением случаев, когда у a есть целочисленный тип данных с точностью меньше, чем у стандартного целочисленного типа платформы. В этом случае используется стандартный целочисленный тип платформы.

outndarray, optional

Альтернативный выходной массив, в который необходимо поместить результат. Он должен иметь ту же форму и длину буфера, что и ожидаемый выход, но тип возвращаемых значений будет преобразован при необходимости.

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

nancumprodndarray

Возвращается новый массив, содержащий результат, если не указан 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.]])