## SHAPE Function

**reshapes and repeats values**
**SHAPE(** *matrix<, nrow<, ncol<,
pad-value>>>***)**

The inputs to the SHAPE function are as follows:
*matrix*
- is a numeric or character matrix or literal.

*nrow*
- gives the number of rows of the new matrix.

*ncol*
- gives the number of columns of the new matrix.

*pad-value*
- is a fill value.

The SHAPE function shapes a new matrix from a matrix with
different dimensions; *nrow* specifies the number of rows,
and *ncol* specifies the number of columns in the new matrix.
The operator works for both numeric and character operands.
The three ways of using the function are outlined below:
- If only
*nrow* is specified, the number of
columns is determined as the number of elements
in the object matrix divided by *nrow*.
The number of elements must be exactly divisible;
otherwise, a conformability error is diagnosed.
- If both
*nrow* and *ncol* are specified, but not
*pad-value*, the result is obtained moving along the
rows until the desired number of elements is obtained.
The operation cycles back to the beginning of the
object matrix to get more elements, if needed.
- If
*pad-value* is specified, the operation moves the
elements of the object matrix first and then fills in any
extra positions in the result with the *pad-value*.

If *nrow* or *ncol* is specified as 0, the
number of rows or columns, respectively, becomes the
number of values divided by *ncol* or *nrow*.
For example, the statement

r=shape(12,3,4);

produces the result shown:
R 3 rows 4 cols (numeric)
12 12 12 12
12 12 12 12
12 12 12 12

The next statement
r=shape(77,1,5);

produces the result matrix by moving along the rows until the
desired number of elements is obtained, cycling back as necessary:
R 1 row 5 cols (numeric)
77 77 77 77 77

The statement below
r=shape({1 2, 3 4, 5 6},2);

has *nrow* specified and converts the
3 ×2 matrix into a 2 ×3 matrix.
R 2 rows 3 cols (numeric)
1 2 3
4 5 6

The statement
r=shape({99 31},3,3);

demonstrates the cycling back and repetition of elements in
row-major order until the number of elements desired is obtained.
R 3 rows 3 cols (numeric)
99 31 99
31 99 31
99 31 99

Copyright © 1999 by SAS Institute Inc., Cary, NC, USA. All rights reserved.