nansum

沿给定轴执行一个跳过 NaN 的求和操作。默认使用所有轴。

参数

名称	类型	描述	默认值
x	SparseArray	要执行约减操作的数组。	必需
axis	Union[int, Iterable[int]]	进行求和的轴。默认使用所有轴。	None
keepdims	bool_	是否保留原始数组的维度。	False
dtype	dtype	输出数组的数据类型。	None

返回值

类型	描述
COO	归约后的稀疏输出数组。

另请参阅

• sparse.COO.sum : 不跳过 NaN 的函数。
• numpy.nansum : 等效的 Numpy 函数。

源代码位于 sparse/numba_backend/_coo/common.py

def nansum(x, axis=None, keepdims=False, dtype=None, out=None):
    """
    Performs a ``NaN`` skipping sum operation along the given axes. Uses all axes by default.

    Parameters
    ----------
    x : SparseArray
        The array to perform the reduction on.
    axis : Union[int, Iterable[int]], optional
        The axes along which to sum. Uses all axes by default.
    keepdims : bool, optional
        Whether or not to keep the dimensions of the original array.
    dtype : numpy.dtype
        The data type of the output array.

    Returns
    -------
    COO
        The reduced output sparse array.

    See Also
    --------
    - [`sparse.COO.sum`][] : Function without ``NaN`` skipping.
    - [`numpy.nansum`][] : Equivalent Numpy function.
    """
    assert out is None
    x = asCOO(x, name="nansum")
    return nanreduce(x, np.add, axis=axis, keepdims=keepdims, dtype=dtype)