# Transpose

Transpose  // Operation that transposes axes of a tensor


## Description¶

Warning

This op is not yet implemented in any backend.

Warning

This op is experimental and subject to change without notice.

Operation that transposes axes of an input tensor. This operation covers matrix transposition, and also more general cases on higher-rank tensors.

### Inputs¶

Name

Element Type

Shape

arg

Any

Any

input_order

element::i64

[n], where n is the rank of arg.

### Outputs¶

Name

Element Type

Shape

output

Same as arg

P(ShapeOf(arg)), where P is the permutation supplied for input_order.

The input input_order must be a vector of shape [n], where n is the rank of arg, and must contain every integer in the range [0,n-1]. This vector represents a permutation of arg’s dimensions. For example,

arg Shape

input_order Value

output Shape

Comment

[3,4]

[1,0]

[4,3]

Transposes the arg matrix.

[3,3]

[1,0]

[3,3]

Transposes the arg matrix.

[3,3]

[1,0]

[3,3]

Transposes the arg matrix.

[3,4,8]

[2,0,1]

[8,3,4]

Moves the “last” dimension to the “first” position.

## Mathematical Definition¶

$\mathtt{output}_{i_0,i_1,...,i_n} = \mathtt{arg}_{i_{\mathtt{input_order}},i_\mathtt{input_order},...,i_\mathtt{input_order}[n]}.$

## Backprop¶

Not yet implemented.

## C++ Interface¶

class Transpose : public ngraph::op::Op

Tensor transpose operation.

Public Functions

const std::string &description() const

Get the string name for the type of the node, such as Add or Multiply. The class name, must not contain spaces as it is used for codegen.

Return

A const reference to the node’s type name

Transpose(const Output<Node> &arg, const Output<Node> &input_order)

Constructs a transpose operation.

Parameters
• arg: Node producing the tensor to be transposed.

• input_order: Node producing the permutation to apply to the axes of the input shape. Must be a vector of element type element::i64, with shape [n], where n is the rank of arg. The tensor’s value must contain every integer in the range [0,n-1].

void validate_and_infer_types`()

Throws if the node is invalid.