IDL

TRANSPOSE

TRANSPOSE

The TRANSPOSE function returns the transpose of Array. If an optional permutation vector is provided, the dimensions of Array are rearranged as well.

Examples


See Additional Examples for more information on using TRANSPOSE.

Example 1

Print a simple array and its transpose by entering:

; Create an array:
A = INDGEN(3,3)
TRANSA = TRANSPOSE(A)
; Print the array and its transpose:
PRINT, 'A:'
PRINT, A
PRINT, 'Transpose of A:'
PRINT, TRANSA

IDL prints:

A:
   0  1  2
   3  4  5
   6  7  8
 
Transpose of A:
   0  3  6
   1  4  7
   2  5  8

Syntax


Result = TRANSPOSE( Array [, P] )

Return Value


Returns the reflection of the array along a diagonal.

Arguments


Array

The array to be transposed.

P

A vector specifying how the dimensions of Array will be permuted. The elements of P correspond to the dimensions of Array; the ith dimension of the output array is dimension P[i] of the input array. Each element of the vector P must be unique. Dimensions start at zero and can not be repeated.

If P is not present, the order of the dimensions of Array is reversed.

Keywords


None.

Additional Examples


Example 2

This example demonstrates multi-dimensional transposition:

; Create the array:
A = INDGEN(2, 3, 4)
; Take the transpose, reversing the order of the indices:
B = TRANSPOSE(A)
; Re-order the dimensions of A, so that the second dimension
; becomes the first, the third becomes the second, and the first
; becomes the third:
C = TRANSPOSE(A, [1, 2, 0])
; View the sizes of the three arrays:
HELP, A, B, C

IDL prints:

A   INT  = Array[2, 3, 4]
B   INT  = Array[4, 3, 2]
C   INT  = Array[3, 4, 2]

Version History


Original

Introduced

See Also


REFORM , ROT, ROTATE, REVERSE

Notes


This page has no user notes yet. Be the first one!


This information is not subject to the controls of the International Traffic in Arms Regulations (ITAR) or the Export Administration Regulations (EAR). However, it may be restricted from transfer to various embargoed countries under U.S. laws and regulations.
© 2014 Exelis Visual Information Solutions