lochange Documentation

lochange - Convert a qmatch list of pixel measurements to mm
lochange creates a geodesy (RAND) measurement file from a qmatch
match point file and a list of cube files that contain all the match
points.  The MATFROM match point file contains the points from which
to generate a geodesy measurement file.

The format of the output file is as follows:

image_number fl point_id x  y  subframe_id  sample  line

where image_number is the full frame image number,
fl is focal length in mm, point_id is an ascii point identifier,
x and y are the point positions in the full frame in mm, subframe_id
is the subframe image number for the corresponding sample and line,
sample and line are the point position in pixels in the specified
subframe.

PROGRAMMER:  Debbie A. Cook, USGS, Flagstaff, Az

Input match file name
(No default extension)

NONE

Output RAND measurement file
(No default extension)

NONE

List of cube files from
which *all* match points
were selected
(no default extension)

NONE

Provided so the user
can specify an alternative
directory to search for
cube files given in the
FROMLIST

--

ADDITIONAL NOTES:

Parm	Description
MATFROM	Input match file name. Contains the list of measured sample/line positions. It has fields containing a point id, image number, line and sample coordinate and point class, sub-pixel correlation and, diameter of measured feature. Only image number and pixel position are used in this application.
RANDTO	Output match file name. This file will be generated from the contents of the MATFROM file. The file will contain a list of the same points as the input file with the following required fields: full frame image number, focal length of the imaging instrument, point id, position of point in full frame in mm (x and y). In addition the program outputs the subframe image number and position of the point in pixels (sample and line).
FROMLIST	ISIS cube list file name. Contains a list of image cubes, one file name per line. Each ISIS cube file in this list must have the IMAGE_NUMBER keyword in the label. Each match point read from the MATFROM file has an image identifier (IMAGE_NUMBER) associated with it. One of the ISIS cube files must contain this identifier.
ALTPATH	This parameter can be used to specify an alternative location of the ISIS cube files that correspond to each match point in RANDTO and specified in FROMLIST. Note that this implies that files listed in FROMLIST may already have a directory path in the file. If the file is not found as it is extracted from FROMLIST, thr program will strip off the existing path and replace it with ALTPATH and attempt to open in in this location. If it is not found in either location, the application terminates abnormally.