PERMUTE Array Permutation Function

Section: Array Generation and Manipulations

Usage

The permute function rearranges the contents of an array according to the specified permutation vector. The syntax for its use is
    y = permute(x,p)

where p is a permutation vector - i.e., a vector containing the integers 1...ndims(x) each occuring exactly once. The resulting array y contains the same data as the array x, but ordered according to the permutation. This function is a generalization of the matrix transpose operation.

Example

Here we use permute to transpose a simple matrix (note that permute also works for sparse matrices):
--> A = [1,2;4,5]

A = 
 1 2 
 4 5 

--> permute(A,[2,1])

ans = 
 1 4 
 2 5 

--> A'

ans = 
 1 4 
 2 5 

Now we permute a larger n-dimensional array:

--> A = randn(13,5,7,2);
--> size(A)

ans = 
 13  5  7  2 

--> B = permute(A,[3,4,2,1]);
--> size(B)

ans = 
  7  2  5 13