As an example of one of these calls:
UFM2CSV mat text
dumps a “binary” matrix mat.ufm into a csv-formatted text file ‘text’ – or, if the second parameter is not included, into a default value mat.txt. It therefore follows (automatically) the procedures described in 10.15.1 (option 4).
A number of varieties of UFM2... exist, essentially one for each of the various output options described in 10.15.1. Thus:
♦ UFM2SATL – dumps in SATURN “long” format
♦ UFM2SATS – dumps in SATURN “short” format
♦ UFM2LINE – dumps single records for non-zero cells
♦ UFM2CSV – dumps as CSV (Comma Separated Variables) with zonal names and/or sequential numbers included as options
♦ UFM2EMME - dumps in EMME/2 format (see 10.15.1.3)
♦ UFM2TBA1/2/3 – dumps in Tuba 1/2/3 formats (see 10.15.1.5)
By default, the output text files use decimal formats with 2 decimal places (10.15.2). To change either it is necessary to change the parameters EFORM and NDPS respectively in the preferences file MX0.DAT.
These procedures are designed to make life easier for users who wish to transfer SATURN matrices into other suites of programs, e.g., EXCEL, in order to make use of particular facilities. To transfer them back into SATURN a complementary set of procedures CSV2UFM, etc. are also provided; see 10.20.16 below.
Supplementary UFM2… Parameters
Extra options/parameters may, in principle, be included following the matrix and/or text names on the command line but at the moment only UFM2TBA2 makes use of this facility. Thus:
UFM2TBA2 mat text KPZ
UFM2TBA2 mat text NOKPZ
allows zero-value cells to be either included (KPZ) or excluded (NOKPZ). Note that filename “text” above is optional.