maxframe.tensor.any#

maxframe.tensor.any(a, axis=None, out=None, keepdims=None)[源代码]#

测试沿给定轴的张量元素是否为 True。

除非 axis 不为 None，否则返回单个布尔值

参数:

  • a (array_like) -- 输入张量或可以转换为数组的对象。

  • axis (None or int or tuple of ints, optional) -- 执行逻辑或归约的轴。默认值（axis = None）是对输入数组的所有维度执行逻辑或操作。axis 可以为负数，此时从最后一个轴开始向前计数。如果这是一个整数元组，则在多个轴上进行归约，而不是像之前那样在单个轴或所有轴上进行。

  • out (Tensor, optional) -- 用于放置结果的替代输出张量。它必须与期望的输出具有相同的形状，并且其类型会被保留（例如，如果它是浮点型，那么它将保持不变，对 True 返回 1.0，对 False 返回 0.0，无论 a 的类型是什么）。详见 `doc.ufuncs`（“输出参数”部分）。

  • keepdims (bool, optional) -- 如果设置为 True，则被归约的轴将保留在结果中，其大小为 1。使用此选项，结果将能够正确地与输入张量进行广播。如果传入默认值，则 keepdims 不会传递给 Tensor 子类的 any 方法，但任何非默认值都会传递。如果子类的 sum 方法未实现 keepdims，则会抛出异常。

返回:

any -- 除非指定了 out，否则返回一个新的布尔值或 Tensor；如果指定了 out，则返回对 out 的引用。

返回类型:

bool or Tensor

参见

Tensor.any

等效方法

all

测试沿给定轴的所有元素是否为 True。

备注

非数字（NaN）、正无穷大和负无穷大都会被评估为 True，因为它们不等于零。

示例

>>> import maxframe.tensor as mt

>>> mt.any([[True, False], [True, True]]).execute()
True

>>> mt.any([[True, False], [False, False]], axis=0).execute()
array([ True, False])

>>> mt.any([-1, 0, 5]).execute()
True

>>> mt.any(mt.nan).execute()
True