mindspore.Tensor.any
- Tensor.any(axis=None, keep_dims=False) Tensor
Reduces a dimension of self by the "logical OR" of all elements in the dimension, by default. And also can reduce a dimension of self along the axis. Determine whether the dimensions of the output and self are the same by controlling keep_dims.
Note
The axis with tensor type is only used for compatibility with older versions and is not recommended.
- Parameters
axis (Union[int, tuple(int), list(int), Tensor], optional) – The dimensions to reduce. Only constant values are allowed. Suppose the rank of self is r, axis must be in the range [-r, r). Default:
None
, all dimensions are reduced.keep_dims (bool, optional) – If
True
, keep these reduced dimensions and the length is 1. IfFalse
, don't keep these dimensions. Default:False
.
- Returns
Tensor, the dtype is bool.
If axis is
None
, and keep_dims isFalse
, the output is a 0-D Tensor representing the "logical OR" of all elements in self.If axis is int, such as 2, and keep_dims is
False
, the shape of output is \((self_1, self_3, ..., self_R)\).If axis is tuple(int) or list(int), such as (2, 3), and keep_dims is
False
, the shape of output is \((self_1, self_4, ..., self_R)\).If axis is 1-D Tensor, such as [2, 3], and keep_dims is
False
, the shape of output is \((self_1, self_4, ..., self_R)\).
- Raises
- Supported Platforms:
Ascend
GPU
CPU
Examples
>>> import numpy as np >>> from mindspore import Tensor >>> x = Tensor(np.array([[True, False], [True, True]])) >>> # case 1: Reduces a dimension by the "logical OR" of all elements in the dimension. >>> output = Tensor.any(x, keep_dims=True) # x.any(keep_dims=True) >>> print(output) [[ True]] >>> print(output.shape) (1, 1) >>> # case 2: Reduces a dimension along axis 0. >>> output = Tensor.any(x, axis=0) # x.any(axis=0) >>> print(output) [ True True] >>> # case 3: Reduces a dimension along axis 1. >>> output = Tensor.any(x, axis=1) # x.any(axis=1) >>> print(output) [ True True]
- Tensor.any(dim=None, keepdim=False) Tensor
Reduces a dimension of self by the "logical OR" of all elements in the dimension, by default. And also can reduce a dimension of self along the dim. Determine whether the dimensions of the output and self are the same by controlling keepdim.
Note
The dim with tensor type is only used for compatibility with older versions and is not recommended.
- Parameters
dim (Union[int, tuple(int), list(int), Tensor], optional) – The dimensions to reduce. Only constant values are allowed. Suppose the rank of self is r, dim must be in the range [-r, r). Default:
None
, all dimensions are reduced.keepdim (bool, optional) – If
True
, keep these reduced dimensions and the length is 1. IfFalse
, don't keep these dimensions. Default:False
.
- Returns
Tensor, the dtype is bool.
If dim is
None
, and keepdim isFalse
, the output is a 0-D Tensor representing the "logical OR" of all elements in self.If dim is int, such as 2, and keepdim is
False
, the shape of output is \((self_1, self_3, ..., self_R)\).If dim is tuple(int) or list(int), such as (2, 3), and keepdim is
False
, the shape of output is \((self_1, self_4, ..., self_R)\).If dim is 1-D Tensor, such as [2, 3], and keepdim is
False
, the shape of output is \((self_1, self_4, ..., self_R)\).
- Raises
- Supported Platforms:
Ascend
GPU
CPU
Examples
>>> import numpy as np >>> from mindspore import Tensor >>> x = Tensor(np.array([[True, False], [True, True]])) >>> # case 1: Reduces a dimension by the "logical OR" of all elements in the dimension. >>> output = Tensor.any(x, keepdim=True) # x.any(keepdim=True) >>> print(output) [[ True]] >>> print(output.shape) (1, 1) >>> # case 2: Reduces a dimension along dim 0. >>> output = Tensor.any(x, dim=0) # x.any(dim=0) >>> print(output) [ True True] >>> # case 3: Reduces a dimension along dim 1. >>> output = Tensor.any(x, dim=1) # x.any(dim=1) >>> print(output) [ True True]