Long Names of Mapping Vectors

ViewHAR will read mapping vectors from a HAR file as lists either of integers or of element names. But not all vectors of integers or strings on a HAR file will be mappings -- so ViewHAR needs some way to recognize mappings. The long name (at right of Contents screen) is used for this purpose: It must follow the pattern below:

Mapping COM2AGGCOM from COM(23) to AGGCOM(10)

The black items are the same for all mappings. The green items are:

COM2AGGCOM - the mapping name (often the name used in TABLO program)

COM(23) - the name of the first set, followed by its size, in parentheses.

AGGCOM(10) - the name of the second set, followed by its size.

Each of the two sets must already be known to ViewHAR (that is, must be stored in the Set Library).

If you add a mapping vector to a HAR file, but do not format the long name in just the right way, ViewHAR will refuse to recognize the strings or integers as a mapping, without giving any warning or message. So work carefully.

If ViewHAR refuses to recognize a set or mapping you created, select the header in the Contents view, right-click, and choose "Properties" -- ViewHAR should tell you WHY it did not recognize the header properly.

If you have GEMPACK 7.0 or later, TABLO programs will automatically write out mappings with long names formatted in the right way (this happens by default, as long as you do not specify a different long name in the Write statement).

Note: Unlike TABLO, ViewHAR allows 2 sets to have the same name as long as their sizes differ. So you could conceivably have a mapping:

Mapping Map1 from COM(23) to COM(10)

URL of this topic: www.copsmodels.com/webhelp/viewhar/hc_longmapname.htm

Link to full GEMPACK Manual

Link to GEMPACK homepage