forked from mindspore-Ecosystem/mindspore
32 lines
1.4 KiB
ReStructuredText
32 lines
1.4 KiB
ReStructuredText
mindspore.ops.select
|
||
====================
|
||
|
||
.. py:function:: mindspore.ops.select(cond, x, y)
|
||
|
||
根据条件判断Tensor中的元素的值，来决定输出中的相应元素是从 `x` （如果元素值为True）还是从 `y` （如果元素值为False）中选择。
|
||
|
||
该算法可以被定义为：
|
||
|
||
.. math::
|
||
|
||
out_i = \begin{cases}
|
||
x_i, & \text{if } cond_i \\
|
||
y_i, & \text{otherwise}
|
||
\end{cases}
|
||
|
||
参数：
|
||
- **cond** (Tensor[bool]) - 条件Tensor，决定选择哪一个元素，shape是 :math:`(x_1, x_2, ..., x_N, ..., x_R)`。
|
||
- **x** (Union[Tensor, int, float]) - 第一个被选择的Tensor或者数字。
|
||
如果x是一个Tensor，那么shape是 :math:`(x_1, x_2, ..., x_N, ..., x_R)`。
|
||
如果x是int或者float，那么将会被转化为int32或者float32类型，并且被广播为与y相同的shape。x和y中至少要有一个Tensor。
|
||
- **y** (Union[Tensor, int, float]) - 第二个被选择的Tensor或者数字。
|
||
如果y是一个Tensor，那么shape是 :math:`(x_1, x_2, ..., x_N, ..., x_R)`。
|
||
如果y是int或者float，那么将会被转化为int32或者float32类型，并且被广播为与x相同的shape。x和y中至少要有一个Tensor。
|
||
|
||
返回：
|
||
Tensor，与 `cond` 的shape相同。
|
||
|
||
异常：
|
||
- **TypeError** - `x` 和 `y` 不是Tensor、int或者float。
|
||
- **ValueError** - 输入的shape不同。
|