## 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