User's Guide

GOF2MGR

Reads a GOF and writes the data to a IBIS graphics file.

Function:

Reads a graphics overlay file (GOF) and writes the data to an image based information system (IBIS) graphics file.

Parameters:

INGOF
Input GOF. The input file is a graphics overlay file.

OUTFILE
Output file. The output file will be in an IBIS graphics file. The polygon to be copied to this file must be the first polygon within the temporary labeled table file.

ATRVAL(-- )
Attribute values. Only records with these 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 (LT) file is deleted or not. This labeled table file is named tem__.


  = YES:  Delete the labeled table file.
  = NO:   Do not delete the labeled table file.

Examples:

  1. LAS> gof2mgr ingof=in.dat outfile=out.dat atrval=-- delflg=no

    The polygon vertices of IN.DAT are read and written to the labeled table file TEM__. The vertices are then written to OUT.DAT in an IBIS graphics format. The labeled table file is not deleted.

  2. LAS> gof2mgr ingof=in.dat outfile=out.dat atrval=(ibis:ibiscutline) delflg=yes

    The polygon vertices that match the attribute IBIS:IBISCUTLINE of IN.DAT are read and written to the labeled table file TEM__. The vertices are then written to OUT.DAT in an IBIS graphics format. The labeled table file is deleted.

Description/Algorithm:

The polygon is retrieved from the GOF and written to a labeled table file called tem__ by the routine GOF2TAB.

   Description of GOF2TAB
   ______________________

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 polygon 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.

The first polygon in the labeled table is read and written to OUTFILE by the routine TAB2MGR.

   Description of TAB2MGR
   ______________________

After reading the input parameters, INLT is opened. The vertices of the polygon are read in. These vertices are then written to the file specified in OUTFILE in an IBIS graphics format. After all the vertices are written, both the files are closed and the completion message is displayed.

The labeled table file is deleted by DELTAB if specified by DELFLG. Error Messages: Error messages are displayed from the called routines.

User Notes:

  1. Any modifications made to GOF2TAB, TAB2MGR, or DELTAB may affect the output of this procedure.

  2. Related modules include MGR2GOF.