A matrix is a convenient way to store an array of numbers. However, often you need to extract certain elements from a matrix. The SAS/IML language aupports two ways to extract elements: by using subscripts or by using indices.
Use subscripts when you are extracting a *rectangular* portion of a matrix, such as a row, a column, or a submatrix.
Use indices when you want to extract values from a non-rectangular pattern.

### Extracting rows, columns, and submatrices

You can extract a submatrix by using subscripts to specify the rows and columns of a matrix. Use square brackets to specify subscripts. For example, if A is a SAS/IML matrix, the following are submatrices:

- The expression A[2,1] is a scalar that is formed from the second row and the first column of A.
- The expression A[2, ] specifies the second row of A. The column subscript is empty, which means “use all columns.”
- The expression A[ , {1 3}] specifies the first and third columns of A. The row subscript is empty, which means “use all rows.”
- The expression A[3:4, 1:2] specifies a 2 x 2 submatrix that contains the elements that are in the intersection of the third and fourth rows of A and the first and second columns of A.

The following SAS/IML statements demonstrate extracting submatrices:

proc iml; A = shape(1:30, 5); /* 5 x 6 matrix */ scalar = A[2,1]; row = A[2, ]; /* 2nd row */ cols = A[ , {3 1}]; /* 3rd and 1st columns */ matrix = A[3:4, 1:2]; /* 2 x 2 matrix: (A[3,1] || A[3,2]) // (A[4,1] || A[4,2]) */ print A, scalar, row, cols, matrix; |

The previous examples were adapted from Wicklin (2013) "Getting Started with the SAS/IML Language", which I recommend for programmers who are starting to learn the SAS/IML language.

### Extracting diagonals and triangular elements

Non-rectangular patterns are common in statistical programming. Examples include the matrix diagonal and the lower triangular portion of a square matrix. The SAS/IML provides special functions for extracting diagonal and triangular regions:

- The VECDIAG function extracts the diagonal of a matrix. The result is a column vector.
- Use the ROW function and COL function to extract an arbitrary diagonal or anti-diagonal pattern, such as elements from a banded matrix.
- Use the SYMSQR function to extract the lower-triangular elements in row-major order.
- Use the VECH function to extract the lower-triangular elements in column-major order.
- The SYMSQR and VECH function extract the diagonal elements, but you can use a trick to remove the diagonal elements and obtain only the elements below the diagonal.

For example, the following statements extract the main diagonal, the lower triangular elements in row-major order, and the lower triangular elements in column-major order:

proc iml; S = shape(1:16, 4); /* 5 x 5 matrix */ v = vecdiag(S); L_row = symsqr(S); L_col = vech(S); print S, v, L_row, L_col; |

### Extracting arbitrary patterns of elements

For the extraction of arbitrary elements, you should use indices. SAS/IML software stores matrices in row-major order, which means the elements are enumerated as you move across the first row, then across the second row, and so forth. However, notice that you do not know the subscripts for A[3] unless you know the shape of A. If A is a 3 x 3 matrix, A[3] corresponds to A[1,3]. However, if A is a 2 x 2 matrix, A[3] corresponds to A[2,1].

The SUB2NDX function enables you to convert subscript information into the equivalent indices. For example, suppose that B is a 5 x 5 matrix and you want to extract the following elements: B[5,2], B[2,4], B[4,3], B[3,1], and B[1,5]. The following statements convert the subscripts into indices and extract the elements:

proc iml; B = shape(1:25, 5); /* 5 x 5 matrix */ subscripts = {5 2, 2 4, 4 3, 3 1, 1 5}; /* five (row,col) subscripts */ ndx = sub2ndx(dimension(B), subscripts); vals = B[ndx]; print vals; |

A powerful advantage of indices is that you can use them to assign values as well as to extract values. For example, if `v` is a five-element column vector, the expression `B[ndx] = v` assigns the values `v` to the elements of B. Notice that this is a vectorized operation. If you do not use indices, you would probably write a DO loop that iterates over the subscripts. In general, vector operations are more efficient than looping operations.

The ability to access elements in an arbitrary order is a big advantage for SAS/IML programmers. Whereas the DATA step processes one observation at a time, the SAS/IML language enables you to access SAS data in whatever order makes sense for the algorithm that you are writing.