lev1matcherr Documentation

lev1matcherr - Report matchpoint errors for a set of level1 cubes
This program computes errors between matchpoints in a matchpoint
file.  It also has options to check for cubes with no matchpoints
and cubes with fewer than 3 matchpoints.  Cubes without any
matchpoints and cubes with matchpoints in error than TOL pixels
can be listed to optional NOMAT and CHECK files.

The program can operate on a single cube using the FROM parameter, or
on a list of cubes using the FROMLIST parameter.

Programmer: Debbie A. Cook, U.S.G.S., Flagstaff, AZ

Input match file name

NONE

File containing a list of cubes

--

Output Rand control point file

--

Output file listing bad points

--

Output file listing cube(s) with
no matchpoints

--

Tolerance for matchpoint errors

6.0

Longitude Direction

--

Print averages in RANDCTL?

Alternate path for cube files in 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.
FROMLIST	A file containing a list of cubes which will all be processed. You can't use FROM if you use this parameter.
RANDCTL	Name of an optional Rand formatted control point file. The file must contain latitude, longitude, radius, and point identifier formatted D19.16,X,D19.16,X,D19.16,X,A6. Example: 2.7511559999999999e+00 3.3831236500000000e+02 1.7374000000000001e+03 LL1001 -1.3355500000000001e-01 3.3879305699999998e+02 1.7374000000000001e+03 LL1002 7.3277570000000001e+00 3.3915195199999999e+02 1.7374000000000001e+03 LL1003 1.7878600000000000e+00 3.3806877800000001e+02 1.7374000000000001e+03 LL1004
CHECK	Name of optional output file listing bad fits. This file is formatted the same as the matchpoint file and contains a subset of the matchpoint file that produces pixel errors over TOL.
NOMAT	Name of optional output file listing cubes that have no matchpoints.
TOL	The line position in the file(s) to describe. See SAMP for the default.
LONGDIR	The positive longitude direction. EAST and WEST are the options, and LONGDIR can also be null. If null, lev1matcherr will use the positive longitude direction in the image labels.
APRIORI	If this is set to AVERAGE, the latitudes and longitudes written to the Rand Control Point file (RANDCTL) will be calculated by averaging the projections of the match points for all of the points in each point set. If set to TRUTH (default), the latitudes and longitudes will simply be the projections of the first match point in a point set. It is believed that averaging causes problems with small sets but may work better in large sets. Unless there is a special reason to do otherwise, it is best to keep the default of "NO".
ERR	If ERR=BOTH, both the error tolerance and the number of points will be checked. If ERR=TOL only the error tolerance will be checked
ALTPATH	This parameter can be used to specify an alternative location of the ISIS cube files corresponding to the match points in MATFROM. If a file in FROMLIST is not found, the application will strip off the existing path, replace it with ALTPATH, and attempt to open the file again. If the file is not found in either location, the application will terminate abnormally.