User's Guide

GOF2TAB

Convert a graphics overlay file (GOF) to a Labeled Table (LT)

Function:

Allows the user to convert a graphics overlay file (GOF) to a labeled table (LT) file. A GOF may be one of four file types: polygon, line, point, or annotation. The corresponding LT for each GOF type consists of two files, the attribute file and the data file.

Parameters:

INGOF
Input graphics overlay file. The extension for the GOF is dependent on FTYPE. The full name of the GOF is assumed to be INGOF;GOF.POINT, INGOF;GOF.LINE, INGOF;GOF.POLY, or INGOF;GOF.ANNOT.

OUTLT
Output labeled table. The name of the LT to be created from the input GOF. The LT created consists of two files. The first record of the master LT file contains the name of the subfile associated with it. The master LT contains graphics labels, attribute names, and values, while the LT subfile contains the point, line, polygon or annotation data.

FTYPE
File type. The type of graphics overlay file to be copied to a LT.
  = POINT:  Point file.  Graphics records of the 
            point GOF are copied to the LT.
  = LINE:   Line file.  Graphics records of the line
            GOF are copied to the LT.
  = POLY:   Polygon file.  Graphics records of the  
            polygon GOF are copied to the LT.
  = ANNOT:  Annotation file.  Graphics records of the
            annotation GOF are copied to the LT.
ATRVAL(--)
Attribute value(s). Attribute values to be copied from the GOF. 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.
TEXT(--)
Text string. File description of the LT. The default description for GOF data is:
   File generated from GOF file <xxxxx> 
where <xxxxx> is the input GOF name.

Examples:

LAS> gof2tab ingof=phoenix outlt=phoenix ftype=point
All points from the GOF PHOENIX;GOF.POINT are copied to the LT named PHOENIX. The LT is defined by two files: PHOENIX;LT and PHOENIX;LT1. File PHOENIX;LT consists of the point labels, attribute names and attribute values. File PHOENIX;LT1 consists of the point data.
LAS> gof2tab ingof=seoul outlt=seoul;lt ftype=poly atrval=("landuse:agr","water:river")
Selected polygons from the GOF SEOUL;GOF.POLY are copied to the LT named SEOUL. The LT is defined by two files: SEOUL;LT and SEOUL;LT1. File SEOUL;LT consists of the polygon labels, attribute names and attribute values. File SEOUL;LT1 consists of the polygon data. All polygons from the GOF that have a LANDUSE attribute of AGR or have a WATER attribute of RIVER are copied to the LT file.

Description/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 polygon, line, point, or annotation data.
GOF2TAB begins by determining what type of GOF data is to be processed based on FTYPE. 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 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.

Nonfatal Error Messages:

None.

Fatal Error Messages:

[gof2tab-attyp] Unknown attribute type in GOF
One of the attributes defined in the GOF being processed contains an unrecognized data type. Currently, the only valid data types for GOF attributes are CHAR (ASCII data), INT (INTEGER*4 data) or REAL (REAL*4 data). Run the function LSTGOF-DEF to determine the names and data types of the attributes defined for the input GOF.
[gof2tab-fatal] Fatal error encountered
A fatal error was encountered during processing. The error message that is displayed preceding this message is the specific error that was encountered.

User Notes:

GOF2TAB is a part of the file interface system. Other programs related to GOF2TAB are:

    Program   Description
    _______   ___________
    TAB2GOF   Converts a labeled table to a GOF
    STAT2TAB  Converts a LAS statistics file to a labeled table
    TAB2STAT  Converts a labeled table to a LAS statistics file

In addition to the above programs, some TAE procedures have been written to transfer data from a source file to a destination file.

    Program   Description
    _______   ___________
    GOF2STAT  Converts a GOF to LAS statistics file
    STAT2GOF  Converts a LAS statistics file to GOF

The following table lists the LT file types created when data is copied from a GOF:
GOF File Type LT File Type _____________ ____________ Point PNTATT, PNTXY Line ARCATT, ARCXY Polygon REGATT, REGXY Annotation ANNOTATT, ANNOTXY
The LT file type REGATT (GOF polygon attribute data) contains the following attribute names:
Attribute Data Name Type Description _________ ____ ___________ REGNUM I*4 Unique region number LABEL C*(*) User defined GOF label "attributes" all Any number of attribute names defined by the GOF
The LT file type REGXY (GOF polygon XY point data) contains the following attribute names:
Attribute Data Name Type Description _________ ____ ___________ REGNUM I*4 Unique region number X R*4 Column number of point Y R*4 Row number of point
The LT file type ARCATT (GOF line attribute data) contains the following attribute names:
Attribute Data Name Type Description _________ ____ ___________ ARCNUM I*4 Unique arc number LABEL C*(*) User defined GOF label "attributes" all Any number of attribute names defined by the GOF
The LT file type ARCXY (GOF line XY point data) contains the following attribute names:
Attribute Data Name Type Description _________ ____ ___________ ARCNUM I*4 Unique arc number X R*4 Column number of point Y R*4 Row number of point
The LT file type PNTATT (GOF point attribute data) contains the following attribute names:
Attribute Data Name Type Description _________ ____ ___________
PNTNUM I*4 Unique point number LABEL C*(*) User defined GOF label "attributes" all Any number of attribute names defined by the GOF
The LT file type PNTXY (GOF XY point data) contains the following attribute names:
Attribute Data Name Type Description _________ ____ ___________ PNTNUM I*4 Unique point number X R*4 Column number of point Y R*4 Row number of point
The LT file type ANNOTATT (GOF annotation attribute data) contains the following attribute names:
Attribute Data Name Type Description _________ ____ ___________ ANNOTNUM I*4 Unique annotation number LABEL C*(*) User defined GOF label "attributes" all Any number of attribute names defined by the GOF
The LT file type ANNOTXY (GOF annotation XY point data) contains the following attribute names:
Attribute Data Name Type Description _________ ____ ___________ ANNOTNUM I*4 Unique annotation number X R*4 Column number of point Y R*4 Row number of point SIZE I*4 Size of annotation font ANGLE R*4 Annotation angle ANNOT C*(*) Annotation text string