任意

测试沿指定轴的任何输入数组元素是否评估为 True。

参数

名称	类型	描述	默认值
x		输入数组。	必需
axis		执行逻辑或归约的轴或多个轴。默认情况下，对整个数组执行逻辑或归约。如果为整数元组，则对多个轴执行逻辑或归约。有效的 axis 必须是区间 [-N, N) 上的整数，其中 N 是 x 的秩（维度数）。如果 axis 指定为负整数，函数将通过从最后一个维度（其中 -1 指最后一个维度）向后计数来确定要执行归约的轴。如果提供了无效的 axis，函数将引发异常。默认值：None。	None
keepdims		如果为 True，则归约的轴（维度）将作为单维度包含在结果中，因此结果必须与输入数组兼容。否则，如果为 False，则归约的轴（维度）不包含在结果中。默认值：False。	False

返回值

名称	类型	描述
out	数组	如果对整个数组执行了逻辑或归约，则返回的数组是包含测试结果的零维数组。否则，返回的数组是包含测试结果的非零维数组。返回的数组类型为 bool。

特殊情况

• 正无穷、负无穷和 NaN 评估为 True。

• 如果 x 具有复浮点数据类型，则具有非零分量（实部或虚部）的元素评估为 True。

• 如果 x 是空数组，或者沿其评估元素的轴（维度）大小为零，则测试结果为 False。

示例

>>> a = sparse.COO.from_numpy(np.array([[0, 1], [2, 0]]))
>>> o = sparse.any(a, axis=1)
>>> o.todense()
array([ True, True])

源代码位于 sparse/numba_backend/_common.py

def any(x, /, *, axis=None, keepdims=False):
    """
    Tests whether any input array element evaluates to ``True`` along a specified axis.

    Parameters
    ----------
    x: array
        input array.
    axis: Optional[Union[int, Tuple[int, ...]]]
        axis or axes along which to perform a logical OR reduction.
        By default, a logical OR reduction is performed over the entire array.
        If a tuple of integers, logical OR reductions are performed over multiple axes.
        A valid ``axis`` must be an integer on the interval ``[-N, N)``, where ``N`` is the rank (number of
        dimensions) of ``x``. If an ``axis`` is specified as a negative integer, the function determines
        the axis along which to perform a reduction by counting backward from the last dimension (where
        ``-1`` refers to the last dimension).
        If provided an invalid ``axis``, the function raises an exception.
        Default: ``None``.
    keepdims: bool
        If ``True``, the reduced axes (dimensions) are included in the result as singleton dimensions,
        and, accordingly, the result must is compatible with the input array. Otherwise, if ``False``,
        the reduced axes (dimensions) is not included in the result.
        Default: ``False``.

    Returns
    -------
    out: array
        if a logical OR reduction was performed over the entire array, the returned array is a
        zero-dimensional array containing the test result.
        Otherwise, the returned array is a non-zero-dimensional array containing the test results.
        The returned array is of type ``bool``.

    Special Cases
    -------------

       - Positive infinity, negative infinity, and NaN  evaluate to ``True``.

       - If ``x`` has a complex floating-point data type, elements having a non-zero component
        (real or imaginary) evaluate to ``True``.

       - If ``x`` is an empty array or the size of the axis (dimension) along which to evaluate elements
         is zero, the test result is ``False``.

    Examples
    --------
    >>> a = sparse.COO.from_numpy(np.array([[0, 1], [2, 0]]))
    >>> o = sparse.any(a, axis=1)
    >>> o.todense()  # doctest: +NORMALIZE_WHITESPACE
    array([ True, True])
    """
    return x.any(axis=axis, keepdims=keepdims)