User's Guide

XUTM

Creates a Geometric Mapping Grid file from systematicly corrected CCT-X MSS scenes

Function:

Creates a Geometric Mapping Grid file for mapping a systematicly corrected CCT-X formatted LANDSAT (1,2,3) image to the UTM map projection at 57 meter pixels.

Parameters:

INFILE

Input file. The input LANDSAT Spacecraft Image Annotation Tape (SIAT) file that contains the scene center. This file is created by PLENTER. The default extension is ";cctx.siat".

OUTGRID

Output grid file. Output geometric mapping grid file containing the geometric mapping grid, as well as projection and framing information of the output space.

PRINT(TERM)

Output destination. The destination of the projection information and resulting center coordinates.

  = --:        No Report
  = TERM:      Terminal.  Output is sent to the user's
               terminal.
  = LP:        Line printer.  Output is sent to the
               printer defined by $PRINTER.
  = Filename:  User-supplied filename.  Output is sent
               to the user-supplied file with the ex-
               tension ".prt".

Examples:

1. LAS> xutm infile=scene1 outgrid=geogrid print=(term,lp)

   The LANDSAT SIAT file SCENE1;CCTX.SIAT is opened and the latitude and longitude center of the scene are read. Projection information and center coordinates are written to both the terminal and the printer defined by $PRINTER. The resulting geometric mapping grid is calculated and written to GEOGRID;GRID.

Description/Algorithm:

The LANDSAT SIAT file is opened and the center latitude and longitude of the scene are read. The UTM zone is calculated and the UTM projection is initialized. The corner coordinates of the input image are calculated, as are the corner coordinates of the map projected output image. Next a mapping between the input image and desired output image space is determined. A 30x30 geometric mapping grid is constructed in the UTM projection at 57 meter pixels. Projection information is written to the geometric mapping grid. RESAMPLE uses the grid to perform the image warping and writes projection information to the resulting image's DDR. The resulting image (created by RESAMPLE) will be corrected to the UTM projection, but will not be rotated north-up. The resulting product closely resembles an EDIPS processed LANDSAT (4,5) MSS-P scene.

Nonfatal Error Messages:

None.

Fatal Error Messages:

1. [xutm-fatal] Fatal error encountered

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

2. [xutm-alloc] Error allocating dynamic memory

   An error occurred allocating memory. Rerun XUTM, and if the error persists, contact the system manager.

3. [xutm-open] Error opening temporary file

   An error was encountered in attempting to open a temporary file. Check the protections on the directory.

User Notes:

1. It is assumed the geometric mapping grid will be used in RESAMPLE with the full scene from tape.

2. This function assumes a systematically corrected MSS CCTformatted image. To get a systematically corrected image, remove synthetic pixels upon ingest (PLENTER) and then remove along-line systematic distortions (XCORRECT). Often users will want to remove radiometric artifacts (DESTRIPE), which should also be run before XUTM and RESAMPLE.

3. A related routine is DSPASSOC.