Help for MARSREMOS

Purpose
-------

The primary use of this program is to quickly make a mosaic using a different 
type of derived image (XYZ, slope, etc) without having to recompute the geometry.

All mosaic programs, such as marsmap, can generate idx/icm files (please, see
the discription of IDX ands ICM parameters).  Marsremose takes as input a list
of images derived from those fed to a mosaic program and uses the generated 
idx/icm files to quickly assemble the derived images into a mosaic.

Radiometric correction is performed on the inputs by default; this may be
turned off via the RAD keyword parameter.

Marsremos will handle color images automatically if the BAND parameter is not
specified. For mixed color and black-and-white inputs, the number of output
bands will equal the maximum number of bands across all inputs. Images with
less than that number of bands will simply repeat the last available band i.e.,
black-and-white images can be mixed with color images. If BAND is specified,
only that single band (in the multi-banded images) is processed, and black-and-
white images remain unaffected.

Execution
---------

There are two ways to present input images:

marsremos inp=(a.img,b.img,c.img,...) out=map.img idx=idx.img icm=icm.img
or
marsremos inp=ascii_listoffiles out=map.img idx=idx.img icm=icm.img

where ascii_listoffiles is a text file created by Sybase or an editor,
containing the list of filenames to include in the mosaic, one per record.
Up to 200 input images can be listed. The required inputs idx.img and 
icm.img are generated by mosaic programs similar to the marsmap program.

Coordinates
-----------

(Almost) all coordinates and angles are measured in the coordinate system
specified by the COORD parameter.  The default is the FIXED coordinate system.

Operation
---------

The program uses  geometry information (idx/icm files) created by mosaic 
progrmas to quickly create a mosaic of derived images.


Index Files
-----------
The required input index (IDX and ICM) files collectively indicate how a 
pixel from an input image file is mapped to the output mosaic file.

The index file (IDX parameter) contains, for each pixel of the output mosaic 
file, a halfword integer (16 bit signed) identifying the image from the list
of inputs where the pixel comes from.  0 indicates no value (black in the 
mosaic).  Numbers from 1-n match the order of files in the input list file 
(or INP parameter, if a list file isn't given).  For most mosaics, the file 
could be converted to byte using CFORM (half is used to support more than 255
input files).

The ICM file (ICM parameter) is an Image Coregistration Map.  It is a
two-band float file containing the (line, sample) coordinate of the input
pixel used for the point.  This is the same basic format as correlation
maps such as MARSCOR3 produces, except that multiple images are involved
(thus the need for the index file).

Limitations
-----------


History
-------
  2020-02-10 esarkiss - Initial version by Edwin Sarkissian. 

COGNIZANT PROGRAMMER:  Bob Deen

PARAMETERS: