mindspore.ops.permute

mindspore.ops.permute(x, dims)[source]

Permutes the dimensions of the input tensor according to input dims .

Parameters
  • x (Tensor) – Input Tensor.

  • dims (Union[tuple(int), list(int), int]) – Permute will permute the tensor to the input dims order.

Returns

Tensor, has the same dimension as input tensor, with dims suitably permuted.

Raises
  • ValueError – If dims is None.

  • ValueError – If the number of elements of dims is not equal to x ndim.

Supported Platforms:

Ascend GPU CPU

Examples

>>> input_x = Tensor(np.array([[[1, 2, 3], [4, 5, 6]], [[7, 8, 9], [10, 11, 12]]]), mindspore.float32)
>>> input_perm = (0, 2, 1)
>>> print(ops.permute(input_x, input_perm))
[[[ 1.  4.]
  [ 2.  5.]
  [ 3.  6.]]
 [[ 7. 10.]
  [ 8. 11.]
  [ 9. 12.]]]