Transpose

Versioned name : Transpose-1

Category : Data movement

Short description : Transpose operation reorders the input tensor dimensions.

Detailed description : Transpose operation reorders the input tensor dimensions. Source indexes and destination indexes are bound by the formula:

\[\begin{split}output[i(order[0]), i(order[1]), ..., i(order[N-1])] = input[i(0), i(1), ..., i(N-1)]\\ \quad \textrm{where} \quad i(j) \quad\textrm{is in the range} \quad [0, (input.shape[j]-1)]\end{split}\]

Attributes : Transpose operation has no attributes.

Inputs :

  • 1 : arg - the tensor to be transposed. A tensor of type T and arbitrary shape. Required.

  • 2 : input_order - the permutation to apply to the axes of the first input shape. A 1D tensor of n elements T_AXIS type and shape [n], where n is the rank of the first input or 0. The tensor’s value must contain every integer in the range [0, n-1], but if an empty tensor is specified (shape [0]), then the axes will be inverted. Required.

Outputs :

  • 1 : A tensor of type T and transposed shape according to the rules specified above.

Types

  • T : any supported type.

  • T_AXIS : any integer type.

Examples

Example 1

<layer ... type="Transpose">
    <input>
        <port id="0">
            <dim>2</dim>
            <dim>3</dim>
            <dim>4</dim>
        </port>
        <port id="1">
            <dim>3</dim>  <!-- [2, 0, 1] -->
        </port>
    </input>
    <output>
        <port id="2">
            <dim>4</dim>
            <dim>2</dim>
            <dim>3</dim>
        </port>
    </output>
</layer>

*Example 2: input_order = empty 1D tensor of Shape[0]

<layer ... type="Transpose">
    <input>
        <port id="0">
            <dim>2</dim>
            <dim>3</dim>
            <dim>4</dim>
        </port>
        <port id="1">
            <dim>0</dim> <!-- input_order is an empty 1D tensor -->
        </port>
    </input>
    <output>
        <port id="2">
            <dim>4</dim>
            <dim>3</dim>
            <dim>2</dim>
        </port>
    </output>
</layer>