User's Guide

ADD2STAT

Combines some or all classes in a statistics file with those of another statistics file

Function:

Combines some or all of the classes contained in one statistics file with those of another statistics file. Each input statistics file remains unchanged. A new statistics file is created which will contain the selected combination of classes.

Parameters:

BASESTAT

Input base statistics file. All statistics are copied from this file into OUTSTAT.

PICKSTAT

Input statistics file from which classes are selected for copying to OUTSTAT.

OUTSTAT

Output statistics file. Receives BASESTAT and selected classes from PICKSTAT.

NCLASS(0)

Number of classes to be copied from PICKSTAT.

  = 0:  copy all classes from PICKSTAT to OUTSTAT.
  > 0:  user will be prompted NCLASS times for 
        class name.

In BATCH mode, NCLASS must be set to zero. The program will abort if it is nonzero.

Examples:

1. LAS> add2stat basestat=stat1 pickstat=stat2 outstat=statout

   This combines all classes from STAT1 AND STAT2 to form a new file STATOUT.

2. LAS> add2stat basestat=stat1 pickstat=stat2 outstat=statout nclass=4

   This combines all classes of STAT1 and four classes from STAT2 to form STATOUT. The user is prompted for the classes to be used from PICKSTAT.

Description/Algorithm:

ADD2STAT copies BASESTAT to the output statistics file and then selectively copies some or all of the PICKSTAT classes to OUTSTAT. If a class selected has the same name as an existing class name in BASESTAT, the user is prompted to rename each of the duplicates for the PICKSTAT classes.

Nonfatal Error Messages:

1. [add2stat-dupname] Duplicate class name found for class: xxx Please enter a new class name

   Name of a selected class is same as one in the base file. User is prompted for a new name.

2. [add2stat-dupname] Duplicate output class name: xxx Please enter a new class name

   The name that user entered already exists in the output file. A new name has to be specified.

Fatal Error Messages:

1. [add2stat-statcopy] Unable to copy statistics file

   Check input statistics file and or disk space.

2. [add2stat-nosite] Unable to get site information

   Error reading a site name. Check input statistics file PICKSTAT.

3. [add2stat-noclass] Unable to get class information

   Error reading a class name. Check input statistics file PICKSTAT.

4. [add2stat-nclass] Number of classes in output file > MAXCLS

   Specify smaller value for NCLASS.

5. [add2stat-classes] Too many classes requested. Restart

   NCLASS was > number of classes in PICKSTAT, and the user did not want to use all the classes. Specify smaller NCLASS.

User Notes:

None.