Language Reference

BTRAN Function

BTRAN (x, n, m) ;

This function is supported by the IML procedure and the iml action.

The BTRAN function computes the block transpose of a partitioned matrix. The arguments to the BTRAN function are as follows:

x

is an left-parenthesis i n right-parenthesis times left-parenthesis j m right-parenthesis numeric matrix.

n

is a scalar with a value that specifies the row dimension of the submatrix blocks.

m

is a scalar with a value that specifies the column dimension of the submatrix blocks.

The argument x is a partitioned matrix formed from submatrices of dimension n times n. If the ith, jth submatrix of the argument x is denoted bold upper A Subscript i j, then the ith, jth submatrix of the result is bold upper A Subscript j i.

The value returned by the BTRAN function is a left-parenthesis j n right-parenthesis times left-parenthesis i m right-parenthesis matrix, the block transpose of x, where the blocks are n times m.

For example, the following statements compute the block transpose of a matrix:

a11 = {1 1,                   /* a 3 x 2 matrix */
       1 1,
       1 1};
a12 = 1 + a11;
a13 = 2 + a11;
a21 = 3 + a11;
a22 = 4 + a11;
a23 = 5 + a11;

x = (a11 || a12 || a13) //    /* a partitioned matrix  */
    (a21 || a22 || a23);      /* each submatrix is a 3 x 2 block */

z = btran(x, 3, 2);           /* transpose the blocks */
print z;

Figure 64: Block Transpose of a Partitioned Matrix

z
1144
1144
1144
2255
2255
2255
3366
3366
3366


Last updated: May 07, 2026