User's Guide

STAT2GOF

Convert a LAS statistics file to a graphic overlay file (GOF)

Function:

Convert polygon data within a LAS statistics file to a graphic overlay file (GOF). The only data type common between the LAS statistics file and GOF files is polygon data.

Parameters:

INSTAT

Input statistics file. The name of the LAS statistics file to be converted into a GOF.

OUTGOF

Output graphics overlay file. The name of the output graphics overlay file.

CLASSNAM(--)

Class name. A list of LAS statistics file class names defining attribute values for the output GOF. Records from the statistics file are copied only if the class name in the statistics file matches a class name in the list defined by CLASSNAM. The default implies all classes are converted.

SITENAM(--)

Site name. A list of LAS statistics file site names defining attribute values for the output GOF. Records from the statistics file are copied only if the site name in the statistics file matches a site name in the list defined by SITENAM. The default implies all sites are converted.

APPDFLG(YES)

Append flag. The user may specify whether or not STAT2GOF should append data records to an existing GOF polygon file.

  = YES:  Append.  Append data to existing GOF
  = NO:   Do not append.  Do not append data to
          existing GOF.

Examples:

1. LAS> stat2gof instat=phoenix outgof=phoenix classnam=-- sitenam=-- appdflg=no

   All polygons in LAS statistics file PHOENIX are copied to GOF file PHOENIX. If the GOF file already exists, a fatal error message is generated because APPDFLG is set to NO. The output GOF will contain the two attributes of CLASS and SITE. The class and site names of the statistics file become attribute values when written to the GOF file.

2. LAS> stat2gof instat=phoenix outgof=phoenix classnam=water sitenam=(lake,river) appdflg=yes

   Polygons with a class name of WATER and a site name of LAKE or RIVER in LAS statistics file PHOENIX are copied to GOF file PHOENIX. If the GOF file already exists, data is appended to the end because APPDFLG is set to YES. The output GOF will contain the two attributes of CLASS and SITE. Existing GOF data will not be altered.

Description/Algorithm:

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

Nonfatal Errors:

Error messages are issued by STAT2TAB and TAB2GOF. The user should refer to the STAT2TAB and TAB2GOF user's guides for error message information.

Fatal Errors:

Error messages are issued by STAT2TAB and TAB2GOF. The user should refer to the STAT2TAB and TAB2GOF user's guides for error message information.

User Note:

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