Level 2 Help for MARSDISPWARP

INP

Input right image and (optional) left image.  Can be any format (except
complex).  Providing the left (second) image is highly recommended, to get
the camera models in the output label correct (see the main help).

The image data and the bulk of the label is taken from the first image.
It is the non-reference image (by convention, "right") used in the correlation
process.  So if the disparity map goes L->R, the input files are (R, L).


OUT

Output warped image.  Image will match the geometry of the reference ("left")
image given to the correlator.


DISP

Input disparity image.  See the correlator programs for a description of
the format.  Must be a single 2-band file.


BAND

The input file band number to use, if a single band is desired.  The default
if not specified is to process all bands.


DISP_PYRAMID

Pyramid level of disparity.  Matches PYRAMID in marsjplstereo and
DISP_PYRAMID in marscor3.  0 means the disparity image is full size,
1 means half size, 2 means quarter size, etc.  See the main help, and
also DISP_ZOOM.


PIXEL_COUNT

If enabled, the number of non-zero pixels will be writen out to
CORRELATION_PIXEL_COUNT in the DERIVED_IMAGE_PARMS label.  For multiband
images, the count is incremented if any of the bands are non-zero (so
100% coverage would be NL*NS, not NL*NS*NB).


DISP_ZOOM

Zoom factor for disparity.  Combined with DISP_PYRAMID via multiplication,
thus final zoom is (2^DISP_PYRAMID)*DISP_ZOOM).  Allows for disparity
zooms other than powers of 2.


ZOOM

Zoom factor for the output image.  Creates an image bigger or smaller than
what it "naturally" would be given the inputs.  See the main help.


INTERP

Turns on or off interpolation in the image.  Interpolation is on by default,
and should be used with normal images.  With the advent of nonzero interp,
interpolation should normally be used, unless warping an image of discrete
values, such as a classification map or status flag band.


DISP_INTERP

Turns on or off interpolation in the disparity map.  Disparity interpolation
is on by default, and should normally be used.  It allows zooms and disparity
zooms to occur without blockiness, but can also be affected by noise in the
disparity map.


NONZERO_INTERP

Turns on or off nonzero interpolation of the pixels.  See the main help for
a description of this algorithm.  Interp must also be on for this to have any
effect.  The default is on.  Nonzero interp is always on for the input
disparity map (unless disp_interp is entirely off).


REF_NOT_ZOOMED

Specifies that the reference image has NOT been zoomed by the disparity zoom.
Useful in certain situations involving chanining of warps through multiple
disparity maps.  See the main help.


SL

Starting line for output.  Specified relative to the "natural" size of the
output (as if this parameter were not given).  Defaults to 1 (no window).


SS

Starting sample for output.  Specified relative to the "natural" size of the
output (as if this parameter were not given).  Defaults to 1 (no window).


NL

Number of lines for output.  Specified relative to the "natural" size of the
output (as if this parameter were not given).  Defaults to full natural size.


NS

Number of samples for output.  Specified relative to the "natural" size of the
output (as if this parameter were not given).  Defaults to full natural size.


NAVTABLE

Corrected navigation filename.
If marsnav was run on the input images it created a table of corrected
pointing parameters. If you refer to this table using NAVTABLE it
will override the pointing parameters (e.g. azimuth and elevation) in the
picture labels, giving you a better registered mosaic.


CONFIG_PATH

A colon-separated list of directories in which to look for configuration
and calibration files.  Environment variables are allowed in the list
(and may themselves contain colon-separated lists).  The directories are
searched in order for each config/cal file when it is loaded.  This allows
multiple projectes to be supported simultaneously, and allows the user to
override any given config/cal file.  Note that the directory structure below
the directories specified in this path must match what the project expects.
For example, Mars 98 expects flat fields to be in a subdirectory named
"flat_fields" while Mars Pathfinder expects them to be directly in the
directory specified by the path (i.e. no intermediate subdirectories).


POINT_METHOD

Specifies a mission-specific pointing method to use.  Normally this
parameter is not used, in which case the "default" pointing methods
are used.  Some missions may have special, or alternate, pointing
methods available, which are indicated by this string (for example,
backlash models, using arm joint angles instead of x/y/z/az/el, etc).
A substring search is used, so multiple methods (where that makes sense)
can be specified by separating the keywords with commas.

Note that nav files created using one pointing method will most likely
not be compatible with a mosaic created using a different pointing method.

Also used for general but uncommonly used parameters in the PIG library.


NOSITE

Disables all label-derived parameters to the Site mechanism which underlies
coordinate systems.  This forces all sites to be identical, with all rotations
and offsets set the same.  In the case of MPF or Mars 98, this disables
the lander quaternion and offset (sets them to identity and 0, respectively).
This option should not be used with images taken from different vantage
points (e.g. the spacecraft moved, or mixing a lander and a rover) or
invalid results will be obtained.  The use of this option invalidates the
Fixed coordinate frame; any values reported in the Fixed frame will not
correctly reflect the orientation of the lander/rover.

Obviously, this option should be rarely used; it is intended for when the
image labels defining the site are invalid or inconsistent.