10.20.29     MXUNBLOCK: Unpack a Blocked  Matrix

MXUNBLOCK  mat  mat1  mat2  mat3….

Outputs a set of square .ufm matrices from a “blocked” matrix mat.ufm, one for each sub-matrix which has been blocked horizontally (see 10.2.4).  Normally the sub-matrices will be “square” but if mat.ufm is stacked both horizontally and vertically, e.g., it is trip matrix for multiple user classes and multiple area charging regimes (see 20.6.12), the output sub-matrices will be stacked with the same number of levels as mat.ufm.

The filenames for the output matrices may either be explicitly listed on the command line as mat1.ufm, mat2.ufm etc. or, if only the filename for the stacked matrix mat.ufm is specified, then the sub-matrices are automatically named mat_1.ufm, mat_2.ufm etc. etc.

It is also possible to select just a single block to be output by a command such as:

MXUNBLOCK  mat  2  matex

Which outputs the second block only from the matrix file mat.ufm to a file matex.ufm (or mat_2.ufm if matex is not given).

See UFMUNSTACK (15.20.18) or UNSTACK (15.20.12) for similar unpacking operations on a matrix which is stacked “vertically”.