User's Guide

TPLMAP

Maps tie point coordinates using a geometric mapping grid.

Function:

Maps tie point coordinates using a geometric mapping grid. The search and reference coordinates of a tie point location file can be mapped as defined by the specified input grid file. TPLMAP can also invert the mapping of the grid using the specified input grid file, on the search and reference coordinates of the tie point location file.

Parameters:

INTL

Input tie point location file. This file contains the search and reference coordinates to be mapped.

INGRID

Input grid file. A geometric mapping grid file containing polynomial coefficients.

OUTTL

Output tie point location file. This tie point location file contains mapped coordinates.

MAPOPT(DIRECT)

Mapping option. Indicator to invert the mapping of INTL.

  = DIRECT: Map as defined by INGRID 
  = INVERT: Invert the mapping as
	    defined by INGRID.

Examples:

1. LAS> tplmap intl=tplfile ingrid=tplgrid outtl=outfile

   All search and reference coordinates in TPLFILE;TPL will be mapped as defined by TPLGRID;GRID. The resulting coordinates will be written to OUTFILE;TPL.

2. LAS> tplmap intl=tplfile ingrid=tplgrid outtl=outfile mapopt=invert

   TPLMAP will invert grid mapping on all search and reference coordinates in TPLFILE;TPL will be mapped according to TPLGRID;GRID. The resulting coordinates will be written to OUTFILE;TPL.

Description/Algorithm:

OUTTL is opened and the header information from INTL is copied into it. If MAPOPT is set to DIRECT all the search and reference coordinates in INTL are mapped as defined by INGRID. If MAPOPT is set to INVERT then TPLMAP will invert the mapping of all the coordinates in INTL using INGRID. The resulting coordinates are written to OUTTL.

Nonfatal Error Message:

1. [tplmap-warn] Nonfatal error encountered

   The error message that is displayed immediately preceding this message is the specific error encountered. Processing continues.

Fatal Error Message:

1. [tplmap-fatal] Fatal error encountered

   The error message that is displayed immediately preceding this message is the specific error encountered. Processing is terminated.

User Notes:

1. TPLMAP can take verification points for a registered image and map them back into the input space where they can be adjusted for effects of relief by RELIEF2. Those points can then be mapped back into the output space using the MAPOPT parameter.

2. Refer to the Geometric Registration Overview for a description of the mapping process.

3. Related routines are DSPTIE, DSPGRID, POLYFIT, and RELIEF2.