merlevpt Documentation

merlevpt - Generate geometric information for a point(s) in a cube
This program generates geometric information for a single sample/line
or x/y/z position or for multiple sample/line positions in a MER
cube or list of cube files.  The information listed includes the
following geometric parameters:

        Sample
        Line
	X
	Y
	Z
	Sample Resolution (M)
	Line Resolution (M)
        Aspect Ratio
	Camera Position (KM) (only if ISIS_GEOMETRY group is complete)

The Camera Position is the position of the spacecraft (x,y,z) in
body-fixed rotating coordinate system.

The program can operate on a single cube using the FROM parameter, in
which case the information is output to the log file (i.e., print.prt)
and the terminal screen.

Or, a FROMLIST can be specified, in which case a list of cubes is
expected to be in the file and the information will be output in ascii
to the file specified by the TO parameter.

The format for TO file is one line for each cube which ran successfully,
where each line contains the following values separated by spaces:

        sample
        line
	x
	y
	z
	sample resolution
	line resolution
        aspect ratio
	camera position
	filename

In addition, a TOERR file can be generated which will contain a list of
cubes that failed.

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

Input cube file name
  (default extension is .cub)

OR

--

File containing a list of cubes

--

File containing a list of points

--

Type of points in PNTLIST
(XYZ,LINESAMP)

--

ASCII file to write information

--

List of unsuccessful cubes

--

Sample position in cube(s)

--

Line position in cube(s)

--

Sample/line increment in
cube(s)

OR

0,0

X of position in cube(s)

--

Y of position in cube(s)

--

Z of position in cube(s)

--

ADDITIONAL NOTES:

Parm	Description
FROM	Input cube file name. If the file extension is omitted, then ".cub" will be assumed. You can't use FROMLIST if you use this parameter.
FROMLIST	A file containing a list of cubes which will all be processed. You can't use FROM if you use this parameter and you must specify TO.
PNTLIST	You can optionally specify a file containing a list of points in the image for which geometric information will be acquired. If you use PNTLIST, then the SAMP, LINE, INC, X, Y, Z parameters will be ignored. If you use PNTLIST, then you must specify the type of data in the list using PNTTYPE. The list must contain a single comma-delimited az,el or line,sample pair per line.
PNTTYPE	If you are using PNTLIST, then you must specify the type of data contained in the list: XYZ or LINESAMP. This parameter is ignored if PNTLIST is not specified.
TO	A file which will contain the output information for the cube(s). This parameter must be specified when a FROMLIST is entered. Type help * to find out about the format of the TO file.
TOERR	A file which will contain the cubes in FROMLIST which failed.
SAMP	The sample position in the file(s) to describe. If SAMP, LINE, X, Y and Z are defaulted, the center of the image will be described.
LINE	The line position in the file(s) to describe. See SAMP for the default.
INC	If no sample/line or x/y/z are entered, then this parameter can be used to specify the sample/line increment to use if information is required for more than one point. If INC=(0,0) and no sample/line or x/y/z are entered, then information will be acquired for the center of the image only. If a sample/line or az/el is entered, then this parameter is ignored. If INC=(1,1), then information is generated for every point in the image. If INC=(10,10), then information is generated for every 10th sample and every 10th line in the image (starting at sample/line=1,1). If this option is used, then information will always be generated for the first/last sample in a line being computed and the first/last line for each sample being computed (regardless of whether the INC ends on the last sample/line).
X	The X position to describe. See LINE for the default.
Y	The Y position to describe. See SAMP for the default.
Z	The Z position to describe. See SAMP for the default.