Level 2 Help for MARSRAD

There are two options for describing input images.
 
1) List the image file names
2) Provide an ascii file with the file names listed, one per record.

If only one value is given, it is assumed that the value is the name of a
file list file.  However, if the file appears to be a VICAR image, then it
is treated as an actual image name.  This means that you can simply correct
a single image:

marsrad inp=a.img out=a.out

without having to create file lists.

There are two options for describing output images.

1) List the image file names
2) Provide an ascii file with the file names listed, one per record.

If only one value is given, it is assumed that the value is the name of a
file list file.  However, if the file appears to be a VICAR image, or if
it doesn't exist, then it is treated as an actual image name.  This means
that you can simply correct a single image:

marsrad inp=a.img out=a.out

without having to create file lists.

Specifies which band from the input image to write to the output image file.
If no band is specified, all bands from the input image will be processed then
written to the output image.

Keyword parameter that turns on or off radiometric correction of the input
images.  RAD (the default) enables the correction (for missions/instruments
which support it), while NORAD disables it.

This parameter is not of much use in MARSRAD, since turning off radiometric
correction would defeat the entire purpose of MARSRAD!  The parameter exists
simply because the common support classes require it.

DN scaling factor.  This factor is used to convert between physical
radiometric units (watts/(meter**2, steradian, micron)) and DN's for the
output mosaic.  The formula is:

true_radiance = offset + (factor * DN)

where "offset" is 0.0 in the current implementation, and "factor" is
1.0 / DNSCALE (making the formula equivalently:  offset + (DN / DNSCALE)).
The offset and factor (1.0/DNSCALE) are written to the output mosaic label.

If FORMAT=REAL is specified, DNSCALE should be set to 1.0, or a warning
will be printed.  The given DNSCALE is still applied, however.

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).

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.

The methods available vary per mission, but some methods available at
the time of this writing are:

BACKLASH : Mars 98 SSI only.  Selects a backlash pointing model,
which adjusts the telemetered azimuth and elevation values based on
knowledge of the camera's mechanical backlash and the direction the
motor was travelling when the image was taken.

Selects short int (HALF) or float (REAL) output format.  The default
is short int; the values are scaled using DNSCALE to the short int range.
However, direct radiometry units can be created using -REAL.  In this case,
DNSCALE should be set to 1.0 (if not, a warning is printed, but DNSCALE
*is* used).

If BITS is specified (and FORMAT=REAL is not), then the results are clamped
to have that many bits, e.g. if BITS is 12 then the results will be in the
range 0-4095.  The sample bit mask in the label will be set appropriately.
As a backward compatibility feature, if BITS is not set then there is no
clamping but the sample bit mask is still set to 15 bits.  BITS is ignored
for floating-point files.

The DATA_SET_NAME typically identifies the instrument that acquired the
data, the target of that instrument, and the processing level of the data.
This value is copied to the output label, property IDENTIFICATION,
keyword DATA_SET_NAME.

The DATA_SET_ID value for a given data set or product is constructed
according to flight project naming conventions.  In most cases the
DATA_SET_ID is an abbreviation of the DATA_SET_NAME.
This value is copied to the output label, property IDENTIFICATION,
keyword DATA_SET_ID.

When a data set is released incrementally, such as every three months during
a mission, the RELEASE_ID is updated each time part of the data set is released.
For each mission(or host id if multiple spacecrafts), the first release of a data
set should have a value of "0001".
This value is copied to the output label, property IDENTIFICATION,
keyword RELEASE_ID.

Specifies a permanent, unique identifier assigned to a data product by
its producer. Most commonly, it is the filename minus the extension.
This value is copied to the output label, property IDENTIFICATION,
keyword PRODUCT_ID.

Specifies the unique identifier of an entity associated with the
production of a data set. This value is copied to the output label,
property IDENTIFICATION, keyword PRODUCER_ID.

Specifies the identity of a university, research center, NASA center or other
institution associated with the production of a data set.
This value is copied to the output label, property IDENTIFICATION, keyword
PRODUCER_INSTITUTION_NAME.

Specifies a target.  The target may be a planet, satelite, ring, region, feature,
asteroid or comet.  This value is copied to the output label, property
IDENTIFICATION, keyword TARGET_NAME.

Specifies the type of a named target. This value is copied to the output
label, property IDENTIFICATION, keyword TARGET_NAME.

The Rover State File is loaded by, but not used by, marsrad.  The parameter
exists for compatibility with subroutines used by other programs (see
e.g. marsmap).

If enabled, this causes the internal database of RMC locations to be
printed out to the stdout log.  This is after the RSF files have been
loaded and the coordinate systems read from the input label(s).

This parameter is ignored by marsrad.  The parameter exists for
compatibility with subroutines used by other programs (see e.g. marsmap).

This parameter is ignored by marsrad.  The parameter exists for
compatibility with subroutines used by other programs (see e.g. marsmap).

This parameter is ignored by marsrad.  The parameter exists for
compatibility with subroutines used by other programs (see e.g. marsmap).