User's Guide

GOF2STAT

Convert a GOF file to a LAS statistics file.

Function:

Allows the user to convert a polygon graphic overlay file (GOF) to a LAS statistics file. If the statistics file already exists, it is updated; otherwise, a new statistics file is created. If the class and site already exist but do not have polygon data, the polygon data are inserted for that site; otherwise, the polygon data are added for new sites.

The polygon data are compatible between the two file formats; however, the GOF attributes and the statistics class and site names are not. The differences are listed in User Note 2.

Parameters:

INGOF
Input graphics overlay file. The input GOF file is required to be polygon data. Other types of GOF data (point, line, and annotation) do not correspond to any of the data types in a LAS statistics file.

OUTSTAT
Output statistics file. If the statistics file already exists, it is updated; otherwise, a new statistics file is created.

CLASSATR("CLASS")
Class attribute. Specifies which GOF attribute name is to be used for the statistics class.

SITEATR("SITE")
Site attribute. Specifies which GOF attribute name is to be used for the statistics site.

CLASSNAM(--)
Class name. A list of GOF attribute values defining class names for the output statistics file. Records from the GOF file are copied only if the attribute value for the class matches the list defined by CLASSNAM. The default implies all attribute values for the class match.

SITENAM(--)
Site name. A list of GOF attribute values defining site names for the output statistics file. Records from the GOF file are copied only if the attribute value for the site matches the list defined by SITENAM. The default implies all attribute values for the site match.

Examples:

  1. LAS> gof2stat ingof=phoenix outstat=phoenix classatr=landuse siteatr=water classnam=-- sitenam=--

    All polygons in GOF file PHOENIX are copied to the LAS statistics file PHOENIX. GOF attribute name LANDUSE is used for the statistics class, and GOF attribute name WATER is used for the statistics site.

  2. LAS> gof2stat ingof=phoenix outstat=phoenix classatr=landuse siteatr=water classnam=(industrial,agr) sitenam=(river,lake)

    Selected polygons in GOF file PHOENIX are copied to the LAS statistics file PHOENIX. GOF attribute name LANDUSE is used for the statistics class, and GOF attribute name WATER is used for the statistics site. Only those polygons that have the specified attribute values are copied; i.e., attribute value of LANDUSE is required to be INDUSTRIAL or AGR and attribute value of WATER is required to be RIVER or LAKE.

Description/Algorithm:

GOF2STAT is a procedure PDF which invokes GOF2TAB to copy the GOF file to a labeled table (LT) file, and TAB2STAT to copy the LT file to a LAS statistics file. The LT files are deleted at completion. See the documentation for GOF2TAB and TAB2STAT for more information.

Nonfatal Error Messages:

    Error messages are issued by GOF2TAB and TAB2STAT. The user should refer to the GOF2TAB and TAB2STAT user's guide for error message information.

Fatal Error Messages:

    Error messages are issued by GOF2TAB and TAB2STAT. The user should refer to the GOF2TAB and TAB2STAT user's guide for error message information.

Usernotes:

  1. The following TAE procedures are involved in transferring polygon data between a statistics file and a graphics overlay file.

          Program	Description
          _______   ___________
    
          GOF2STAT  Converts GOF file to LAS statistics file
          STAT2GOF  Converts LAS statistics file to GOF file
          GOF2TAB	Converts GOF file to a labeled table
          TAB2GOF	Converts labeled table to a GOF file
          STAT2TAB	Converts LAS statistics file to a labeled table
          TAB2STAT	Converts labeled table to a LAS statistics file
          DELTAB    Deletes a LT and its associated files
    

  2. The differences between GOF attributes and the statistics class and site names are as follows:

        _______________________________________________________
                GOF File          |         Statistics File
                                  |
        Allows up to 35 attribute | Allows a class and site to 
        names and a 13 character  | define the polygon.  Input 
        description to define the | parameter CLASSATR  
        polygon.                  | specifies which attribute   
                                  | name is to be used for     	
                                  | the class.  Input parameter 
                                  | SITEATR specifies which  
                                  | attribute name is to be   
                                  | used for the site.  
                                  |
        Allows duplicate attribute| A class may have more than
        values.                   | one site.  Sites cannot   
                                  | have duplicate names; so   
                                  | if the site already exists, 
                                  | the site name is appended
                                  | with "_x", where x is an 
                                  | ascending numeric value     
                                  | starting with 1.  
                                  |
        Allows attribute values   | The class and site names   
        to have blanks embedded.  | cannot have blanks 
                                  | embedded; so all blanks are 
                                  | replaced with "_" by GOF2STAT.
                                  |
        Data type of attributes   | Data type of class and  
        may be character, integer,| site names are required  
        or real.                  | to be character; so the   
                                  | character representation    
                                  | of other data types, i.e.,    
                                  | BYTE, I*2, I*4, R*4, R*8,    
                                  | are delimited by quotes.
                                  |
        Allows attribute values   | Class and site names cannot 
        to be null.               | be null.  If the class  
                                  | is null, it is assigned a    
                                  | value of "CLASS_x", where 
                                  | x is an ascending numeric    
                                  | value.  If the site is  
                                  | null, it is assigned a   
                                  | value of SITE.
        __________________________|________________________________