Sets on Header Array Files

Sets are stored on Header Array files as part of real matrices, or individually. In the latter case, the set is stored as an array of strings.

The difficulty for ViewHAR is to guess (a) which string arrays contain sets, and (b) what are the names of these sets.

The longname part of the header should be used to record the name of the set, according to the following convention:

Set IND sectors in the model

The first word should be Set and the second word should be the name of the set. ViewHAR ignores all words after the first two.

ViewHAR prefers the convention above but will also accept

IND sectors in the model

More precisely, if the first word of the longname is "Set" then ViewHAR assumes that the second word is the name of the set. Otherwise ViewHAR assumes that the first word is the name of the set. If there is no longname, ViewHAR invents a name for the set.

If you have GEMPACK 7.0 or later, TABLO programs will automatically write out sets with long names formatted in the right way if you do not specify a long name in the Write statement. Use a TABLO statement such as

Write (set) COM to file OUTHAR header "YY03";

If the maximum length of elements in a string array exceeds the maximum length (12) of a set element name in GEMPACK, ViewHAR assumes that this string array does not contain set elements.

Similarly, if any element in a string array contains characters (such as blanks or hyphens) which are not allowed in a GEMPACK set element name, ViewHAR assumes that this string array does not contain set elements.

Why is my set not in the Set Library ?

When ViewHAR decides that a string array does not contain set elements, there is no warning or error message to explain why. You might be puzzled, why ViewHAR did not recognize as a set some string array that you created. In that case, right-click on the header in the Contents page and select Properties -- there will be a message "Is a valid set" or else an explanation why the string array does not qualify. However, even valid sets will not be added to ViewHAR's set library, if the library already contains a set of the same name and size.