User's Guide

TAB2MGR

Reads a polygon labeled table file and writes the data to a IBIS graphics file.

Function:

Reads a polygon labeled table (LT) file and writes the data to an image based information system (IBIS) graphics file.

Parameters:

INLT
Input labeled table. The input file is a polygon labeled table file. This labeled table file cannot have more than one subfile.

OUTFILE
Output file. The output file will be in an IBIS graphics file.

ATRNAME(REGNUM,Y,X)
Attribute names. The name of the attributes which correspond to polygon feature number, line(y) location, and sample(x) location. The values specified for ATRNAME must be in the order listed below.

	ATRNAME(1) = polygon feature number
	ATRNAME(2) = line(y) location
	ATRNAME(3) = sample(x) location

POLYNUM(1)
Polygon feature number. This is the number of the polygon that is needed. This value is compared with the value that corresponds to ATRNAME(1).

Example:

  1. LAS> tab2mgr inlt=in.dat outfile=out.dat atrname=(regnum,y,x) polynum = 1

    The values of the attributes Y and X that have a REGNUM of 1 are read from the labeled table IN.DAT and written as a polygon to OUT.DAT in an IBIS graphics format.

Description/Algorithm:

After reading the input parameters, INLT is opened. The label of each record is checked to verify that the specified attributes are included in the file. 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.

Nonfatal Error Message:

  1. [tab2mgr-warn] Nonfatal error encountered

    A nonfatal error was encountered during processing. The output file is still valid, and processing will continue. The message that is displayed immediately preceding this message is the specific error that was encountered.

Fatal Error Messages:

  1. [tab2mgr-attrib] LT attribute name <X> was not found

    The program was unable to find the attribute name <X> in the LT. Respecify this attribute.

  2. [tab2mgr-fatal] Fatal error encountered

    A fatal error was encountered during processing. The output file may or may not be deleted, and processing is terminated. The message that is displayed immediately preceding this message is the specific error that was encountered.

  3. [tab2mgr-open] Error opening <XXXXXX> file

    The <XXXXXX> file could not be opened and processing is terminated. Verify that the <XXXXXX> file exists.

  4. [tab2mgr-read] Error reading input file

    An error occurred when reading the input file. Check the format of the file.

  5. [tab2mgr-write] Error writing to the <XXXXXXX> file

    The <XXXXXXX> file could not be written to. Verify that disk space is available.

User Note:

  1. Related modules include GOF2MGR, MGR2GOF, and MGR2TAB.