Generates an IBIS tabular file from a GOF that contains points.
Generates an image based information system (IBIS) tabular file from a graphics overlay file (GOF) that contains points. Each record of the GOF is read and written out to the tabular file.
- INGOF
- Input name. Input name of the graphics overlay file.
- OUTFILE
- Output file. Output IBIS tabular file.
- OUTCOL(3,9,10)
- Output columns. The destination columns in the output IBIS tabular file. Columns not specified are filled with zeros. The number of values specified for OUTCOL and ATRNAME must be equal.
- ATRNAME(PNTNUM,Y,X)
- Attribute names. The values that are associated with these LT attribute names are copied to the output columns specified by OUTCOL. The number of values specified for ATRNAME and OUTCOL must be equal.
Below are three special LT attributes used when creating the temporary labeled table and their descriptions. All other attributes should be specified as they are defined within the GOF.
PNTNUM -- Point number Y -- Y (line) location of the point X -- X (sample) location of the point
- NCOLS(30)
- Number of columns. The number of columns to be created in the output IBIS tabular file. The default value causes NCOLS to be set as the largest column number in OUTCOL. If a value specified is less than the largest column number in OUTCOL, NCOLS is reset with the larger value.
- ATRVAL(-- )
- Attribute values. Only records with these GOF attribute names and corresponding attribute values are copied to the LT file. The default is to copy all GOF records to the LT file. Attributes must be entered in the following format.
ATTRIBUTE NAME:ATTRIBUTE VALUE (Note that a colon with no blank spaces must be used to separate the attribute name from the attribute value.)ATTRIBUTE NAME: may also be specified to copy all records that have the attribute regardless of the value. ATTRIBUTE NAME is an 8-character name that must be defined in the graphics overlay file being processed. ATTRIBUTE VALUE is a 12-character string that must be a valid value for the data type defined for ATTRIBUTE NAME. The default is to copy all graphics data from the specified GOF regardless of the attribute values.
- DELFLG(YES)
- Delete flag. This option determines if the labeled table file is to be deleted or not. This labeled table file is named tem__.
= YES: Delete the labeled table file. = NO: Do not delete the labeled table file.
All the attributes in IN.DAT are written to TEM__. The output file OUT.DAT contains 15 columns as specified by NCOLS. Columns 1, 5, 4 contains the values of the LT attributes named PNTNUM, Y, and X of TEM__. The other columns contain zeros. The labeled table file is deleted.
GOF2TAB generates TEM__ from IN.DAT. TEM__ contains the values that correspond to the GOF record that has an attribute name of RECORD and an attribute value of 1.0. TAB2MTB places the values of the LT attributes Y, X, PNTNUM of TEM__ in columns 7, 9, 1 of OUT.DAT. The output file OUT.DAT contains 9 columns because column 9 is the largest column specified in OUTCOL. The columns not specified contain zeros. The labeled table file is not deleted.
The procedure calls GOF2TAB to retrieve the attributes from the GOF and writes them to a labeled table file. The labeled table file name is TEM__.
GOF2TAB algorithm _________________The output LT created by GOF2TAB is defined by two files. The master LT file consists of graphics labels, attribute names and attribute values while the associated LT subfile consists of the point data.
The appropriate GOF is then opened and its header record is read. The output LT files are also opened; and from information in the GOF header record, the LT label vector is written. The list of attribute names and values in the parameter ATRVAL define which GOF records are to be transferred to the LT files. After all records of the GOF have been read and copied, the GOF and LT files are closed and a standard completion message is written to the user's terminal.
TAB2MTB is then called to write the elements from the labeled table into the correct column of an IBIS tabular file.
TAB2MTB algorithm _________________The program begins with the standard initialization and retrieval of user-specified parameters. If necessary, the defaulted parameters are set with the appropriate values. The labeled table file is read and the number of points that the labeled table contains is calculated. The output IBIS tabular file is opened with the number of rows equal to the number of points found in the input file. Row by row, the input file values of the attributes specified are written to the columns specified in the output file. When all the points have been written to the output file, all the files are closed and the completion message is displayed.
If specified DELTAB will delete the labeled table file and its subfiles. Error Messages: Error messages are displayed from the called routines.
User Notes:
- Any modifications made to the programs GOF2TAB, TAB2MTB, or DELTAB may change the output of the procedure.
- Related modules are MTB2GOF, MTB2TAB, and TAB2MTB.