User's Guide

TAB2TIE

Converts a Labeled Table(LT) file to a tie point selection file.

Function:

Converts a labeled table (LT) file to a tie point selection file. The values of each of the field names specified will be read from the input labeled table and written to the output tie point file. The main labeled table can have subfiles, but the subfiles cannot have subfiles.

Parameters:

INLT

Input labeled table file. This is a labeled table file that contains information to be placed into a tie point selection file. The main labeled table can have subfiles, but the subfiles may not have subfiles.

OUTTS

Output tie point selection file. The output tie point selection file that is created from the input labeled table file.

COORSATR(--)

Coordinates attribute. The attribute name of the field that defines the coordinates of the tie point. These are geographic coordinates, projection coordinates, or user-defined coordinates. This can be specified as a single 1 x 2 matrix attribute or as two 1 x 1 matrix attributes.

LSCATR(--)

Line/sample coordinates attribute. The attribute name of the field that defines the location of the tie point in the image coordinates. This can be specified as a single 1 x 2 matrix attribute or as two 1 x 1 matrix attributes.

PVALATR(--)

Projection validity attribute. The attribute name of the field that contains the validity of the projection-related fields.

CORNATR(--)

Corners attribute. The attribute name of the field that contains the location of the corners. It is assumed that the coordinate pairs are stored in the input labeled table in latitude/longitude or northing/easting order. Is is also assumed that the pairs of coordinates are stored in the upper-left, lower-left, upper-right, and lower-right order. This can be specified as a single 2 x 4 matrix attribute or as four 1 x 2 matrix attributes.

PDATR(--)

Projection distance attribute. The attribute name of the field that contains the distance on the ground that one sample represents in projection units. The projection distance is stored in the input labeled table in line/sample order. This can be specified as a single 1 x 2 matrix attribute or as two 1 x 1 matrix attributes.

PPARMATR(--)

Projection parameters attribute. The attribute name of the field that contains the parameters that are required in order to define each map projection. Refer to the LAS Projection Transformation Package for further details.

PTYPEATR(--)

Projection type attribute. The attribute name of the field that defines the projection type. This type is used by the LAS Projection Transformation Package to indicate map projection systems. Refer to the Geometric Manipulation Package Overview Document (GEOMPOD) for further details.

ZONEATR(--)

Zone number attribute. The attribute name of the field that defines the zone to be used for UTM and State Plane projection systems. Refer to the Geometric Manipulation Package Overview Document (GEOMPOD) for further details.

DCODEATR(--)

Datum code attribute. The attribute name of the field that defines the datum to be used for setting the semi-major axis and eccentricity squared for a particular projection. Refer to the LAS Projection Transformation Package for further details.

MODEATR(--)

Tie point mode attribute. The attribute name of the field that defines the type of coordinates in the tie point file.

PUNITATR(--)

Projection measurement unit attribute. The attribute name of the field that defines the measurement system used for the projection dimensions.

NAMEATR(--)

Image name attribute. The attribute name of the field that defines the LAS name of the image from which points were obtained.

PTIDATR(--)

Tie point id attribute. The attribute name of the field that defines the tie point identification field describing each point. It must be unique among points in the file.

ELEVATR(--)

Elevation attribute. The attribute name of the field that defines the elevation of the tie point.

SCALFATR(--)

Scale factor attribute. The attribute name of the field that defines the enlargement factor used when selecting the tie point. This gives an indication as to the possible subpixel accuracy of the tie point.

REFSZATR(--)

Reference size attribute. The attribute name of the field that defines the desired subimage width and height as used by the CORRELATE application. This can be specified as a single 1 x 2 matrix attribute or as two 1 x 1 matrix attributes.

SRCOFATR(--)

Search offsets attribute. The attribute name of the field that defines the desired horizontal and vertical search offsets as used by the CORRELATE application. This can be specified as a single 1 x 2 matrix attribute or as two 1 x 1 matrix attributes.

CNAMEATR(--)

Subimage chip name attribute. The attribute name of the field that defines the LAS image name of the file containing the subimage chip.

Example:

1. LAS> tab2tie inlt=in.dat outts=out.dat coorsatr=(coordy, coordx) pvalatr=pvalid modeatr=mode ptidatr=pntnum

   The values of the fields PVALID, MODE, PNTNUM, COORDY, and COORDX will be read from the IN.DAT and its subfiles. These values will be written to the tie point selection file named OUT.DAT

Description/Algorithm:

After reading and parsing the parameter values, the input labeled table and output tie point files are opened for read and write, respectively. Only the attribute names that are specified as input will have their information written to the tie point file. All other fields of the tie point file will be set to the value of 0 if the field is a numeric value or a blank if the field is a character string. After all the requested information has been written to the output tie point file, the files are closed and the completion message is displayed.

Nonfatal error messages:

None.

Fatal error messages:

1. [tab2tie-attribute] Attribute <XXXX> was not found

   The attribute <XXXX> was not found in the main labeled table file or any of its subfiles. Respecify the attribute name.

2. [tab2tie-coor] Either COORSATR or LSCATR must be specified

   Either the COORSATR or LSCATR parameter must be specified to have a valid tie point file. Specify either COORSATR or LSCATR.

3. [tab2tie-fatal] Fatal error encountered

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

4. [tab2tie-open] Error opening <XXXXX> file

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

5. [tab2tie-read] Error reading input file

   An error was encountered while trying to read the specified file. Verify the format of the file.

6. [tab2tie-write] Error writing output file

   An error was encountered while trying to write the specified file. Verify the amount of disk space available.

User Note:

1. No error checking is being done on the actual values of each of the input fields.