Example: Forward conversion

In this example, conn_2.msg and conn_2.idx are files of the old SMAT format.

You then use this command:

hcismatconvert conn_2 -o conn_2_new

This takes the contents of conn_2.msg and conn_2.idx, converts them to the new format, and writes them to files named conn_2_new.msg and conn_2_new.idx.

Metadata fields not stored in the old format are given default values. Note that the two .msg files are identical because variable-length metadata would default to length zero.

When -o is specified, the .ecd file is also copied to the output file name.

hcismatconvert conn_2 would do the same conversion, but overwrite conn_2.idx; conn_2.msg would remain unchanged.