User's Guide

TAB2MTB

Generates an IBIS tabular file from a labeled table file that contains points.

Function:

Generates an image based information system (IBIS) tabular file from a labeled table (LT) file that contains points. Each record of the labeled table is read and written out to the IBIS tabular file.

Parameters:

INLT
Input labeled table. This labeled table file contains points that are stored in the attributes specified in ATRNAME.

The LT may consist of one or two files. If there are two files, the first record of the master LT file contains the name of the subfile that is associated with it.

OUTFILE
Output file. Output IBIS tabular file that will contain the values associated with the specified attribute names.

ATRNAME(PNTNUM,Y,X)
Attribute names. The values that are associated with these attribute names is copied to the output columns specified by OUTCOL. The number of values specified for ATRNAME and OUTCOL must be equal.

OUTCOL(3,5,6)
Output columns. The destination columns in the output IBIS tabular file. Columns not specified are filled with zeros. The number of values specified for OUTCOL and ATRNAME must be equal.

NCOLS(30)
Number of columns. The number of columns to be created in the output IBIS tabular file. The default value causes NCOLS to be set as the largest column number in OUTCOL. If a value specified is less than the largest column number in OUTCOL, NCOLS is reset with the larger value.

Examples:

  1. LAS> tab2mtb inlt=in.dat outfile=out.dat atrname=(pntnum,y,x) outcol=(1 5 6) ncols=15

    The output file OUT.DAT contains 15 columns as specified by NCOLS. Columns 1, 5, 6 contain the values that correspond to the attributes of the labeled table PNTNUM, Y, X. The other columns contain zeros. One row in OUT.DAT is created for each control point found in IN.DAT.

  2. LAS> tab2mtb inlt=in.dat outfile=out.dat atrname=(pntnum,iny,inx,outy,outx) outcol=(1 5 6 7 8) ncols=5

    The output file OUT.DAT contains 8 columns because column 8 is the largest column specified in OUTCOL. Columns 1, 5, 6, 7, 8 contain the values that correspond to the attributes of the labeled table named PNTNUM, INY, INX, OUTY, OUTX. The columns not specified contain zeros. One row in OUT.DAT is created for each control point found in IN.DAT.

Description/Algorithm:

The program begins with the standard initialization and retrieval of user-specified parameters. If necessary, the defaulted parameters are set with the appropriate values. The labeled table file is read and the number of control points that the labeled table contains is calculated. The output IBIS tabular file is opened with the number of rows equal to the number of control points found in the input file. Row by row, the input file values of the attributes specified are written to the columns specified in the output file. When all the control points have been written to the output file, all the files are closed and the completion message is displayed.

Nonfatal Error Messages:

    None.

Fatal Error Messages:

  1. [tab2mtb-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. [tab2mtb-dtype] Dtype of label is invalid

    The data type of the specified attribute label is not valid. Check the data type of the attribute label in the LT file.

  3. [tab2mtb-equal] No. of attributes and columns are not equal

    The ATRNAME and OUTCOL parameters have to have the same number of elements in each. Respecify one of the two parameters.

  4. [tab2mtb-fatal] Fatal error encountered

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

  5. [tab2mtb-open] Error opening <XXX> file

    An error was encountered while trying to open the specified file. Verify that the file exists.

  6. [tab2mtb-sub] Only one subfile is allowed

    Only one subfile is allowed as input. Combine the multiple subfiles into one subfile.

  7. [tab2mtb-write] Error writing output file

    An error was encountered while trying to write to the IBIS tabular file. Verify that disk space is available.

User Note:

  1. Related modules are GOF2MTB, MTB2GOF, and MTB2TAB.