mindspore.ops.atleast_3d

mindspore.ops.atleast_3d(inputs)[源代码]

调整 inputs 中的Tensor维度，使输入中每个Tensor维度不低于3。

Scalar、一维或二维Tensor被转换为三维Tensor，而高维输入则被保留。

参数：

inputs (Union[Tensor, list[Tensor]]) - 一个或多个输入Tensor。

返回：

Tensor或Tensor列表。如果返回列表，则列表中的每一个元素 a 满足： a.ndim >= 3。例如，一个shape为 \((N,)\) 的Tensor，操作后shape变成 \((1, N, 1)\) ，shape为 \((M, N)\) 的2-D Tensor shape变成 \((M, N, 1)\) 。

异常：

TypeError - input 不是一个Tensor或Tensor列表。

支持平台：

Ascend GPU CPU

样例：

>>> x1 = Tensor(np.ones((2, 3)))
>>> x2 = Tensor(np.ones(()))
>>> x3 = Tensor(np.ones(5))
>>> out = ops.atleast_3d([x1, x2, x3])
>>> print(out[0].asnumpy())
[[[1.]
  [1.]
  [1.]]

 [[1.]
  [1.]
  [1.]]]
>>> print(out[1].asnumpy())
[[[1.]]]
>>> print(out[2].asnumpy())
[[[1.]
  [1.]
  [1.]
  [1.]
  [1.]]]