matlab (version 1.0.2)

reshape: MATLAB reshape function

Description

Reshape matrix or array.

Usage

reshape(A, ...)

Arguments

A

matrix or array containing the original data

...

numeric dimensions for the result

Value

Returns matrix (or array) of requested dimensions containing the elements of A.

Details

In the first example below, an m-by-n matrix is created whose elements are taken column-wise from A. An error occurs if A does not have $m*n$ elements.

In the second example below, an n-dimensional array with the same elements as A but reshaped to have the size m-by-n-by-p. The product of the specified dimensions must be the same as prod(size(A)).

In the third example below, an n-dimensional array with the same elements as A but reshaped to siz, a vector representing the dimensions of the reshaped array. The quantity prod(siz) must be the same as prod(size(A)).

Examples

Xmat.2d <- matrix(1:12, nrow=4, ncol=3)
reshape(Xmat.2d, 6, 2)                   # example 1
reshape(Xmat.2d, c(6, 2))                    # same thing
Xarr.3d <- reshape(Xmat.2d, c(6, 2, 1))  # example 2
reshape(Xmat.2d, size(Xarr.3d))          # example 3