mer2isis Documentation

mer2isis - Convert MER flight/calibration images to ISIS format
OVERVIEW

This procedure converts PDS-formatted MER flight files and
calibration files to ISIS-formatted cube files. The use of
this procedure will take the burden of detemining which
translation table (TRANSTAB) to use off of the user. The
procedure automatically determines which table to use based
on the DATA_SET_ID in the PDS file. If no DATA_SET_ID exists
in the input file, then the MER flight data translation table
will be used as a default.

This procedure will also rotate a MER image if requested to do
so. If the ROTATE parameter is set to YES, then the input image
will be flipped top to bottom (rotated 180 degrees clockwise).

The procedure can be used to process a single input file
(specified by the FROM parameter) or a list of files (specified
by the FROMLIST parameter).

PROCESSING WITHOUT USE OF TAE

This procedure provides an interactive interface to the PERL
scripts that perform the work involved in converting the PDS
files to ISIS cubes. The PERL scripts can also be run
standalone from the command line which makes them ideal for use
in web.html applications. There are two PERL scripts available
for converting PDS-formatted MER flight/calibration files
to ISIS cubes:

mer2isis.pl, mer2isis_batch.pl

The mer2isis.pl script will process a single file for each
execution of the script. The mer2isis_batch.pl script allows you
to process a list of files for each execution of the script.

The syntax for processing a single file is as follows:

mer2isis.pl FROM=from [TO=to] [TRANSTAB=transtab] [KEEPBYTE=keepbyte]
[ROTATE=rotate]

The syntax for processing a list of files is as follows:

mer2isis_batch.pl FROM=fromlist [TRANSTAB=transtab] [KEEPBYTE=keepbyte]
[ROTATE=rotate]

All the parameters in square brackets [] above are optional. The
parameters in square brackets can be used to specify how the output
cube is created. Each parameter has a KEYWORD=value syntax associated
with it. In order to specify a parameter on the command line, you
must specify the keyword in upper case (FROM, TO, TRANSTAB, KEEPBYTE,
ROTATE) followed by an '=' sign and the value. Do not put any spaces in
the parameter specification. The parameters can occur in any order. If
an optional parameter is not specified, then a default value will be
supplied by the Perl script. If a TO file is not supplied, then the
script will create a filename by replacing the extension on the FROM
file with '.cub'. If the FROM file is called mer01.pds, then the default
output file will be called mer01.cub. The following example will process
a single file (called mer01.pds), set the translation table to
mer2isis_translation.def.1, and let the output file name default:

mer2isis.pl FROM=mer01.pds TRANSTAB=mer2isis_translation.def.1

Because the order of parameters does not matter, the command could
also have been specified as:

mer2isis.pl TRANSTAB=mer2isis_translation.def.1 FROM=mer01.pds


PROCESSING AND ERROR LOGGING

If an error occurs during processing, then mer2isis.err will be
created which will contain some error-related information. The session
log file (print.prt unless the ISIS_LOG_FILE environment variable has
been set) will contain a complete history of the processing as well as
additional error information.

Programmer:  Janet Barrett, U.S.G.S., Flagstaff, 6 Nov 2003

Input PDS filename
 (file extension required)

--

List of input PDS filenames

--

Output filename
 (default extension is .cub)

--

Name of translation
table file

--

Keep the prefix and suffix
bytes in the core?

NO

Rotate the image 180 degrees
clockwise?

NO

ADDITIONAL NOTES:

Parm	Description
FROM	This is a PDS-formatted MER flight or calibration file. The file extension must be included with the filename. The input file can be 8, 16, or 32 bit. The output file will be the same data type as the input file. If FROM is specified, then the FROMLIST parameter must be specified as the Null TAE parameter value.
FROMLIST	This specifies a file that contains a list of PDS-formatted files to be processed. The input list must be a single column file that contains one input PDS file name per line. The file extension of the filenames in the list must be included. The input files can be 8, 16, or 32 bit. The output files will be the same data type as the input files. If FROMLIST is specified, then the FROM parameter must be specified as the Null TAE parameter value. The output filenames will automatically be created by using the 'root' input name (without extension) with ".cub" appended.
TO	If a single file is processed using the FROM parameter, then this parameter can be used to name the output file. If the file extension is omitted, then ".cub" will be assumed. This parameter is ignored when a FROMLIST is entered. If the FROMLIST option is used or if this parameter is left blank, then the output filename will default to be the 'root' name of the input file (without extension) with ".cub" appended.
TRANSTAB	This is the translation table to be used by pds2isis for translating PDS labels keywords to ISIS label keywords. The default is to use the latest version of the mer2isis_translation.def or mercal2isis_translation.def files in $ISISMERDATA for flight or calibration data.
KEEPBYTE	Determines if the prefix and suffix data in a MER calibration file will be removed or propagated into the core of the output ISIS file. If KEEPBYTE=YES, then the prefix/suffix data will be propagated into the core. The number of samples in the output ISIS image will be the number of samples in the PDS file plus the number of prefix/suffix pixels. If KEEPBYTE=NO, then the prefix/suffix data will be removed before the core data is written to the output ISIS file. The default is KEEPBYTE=NO. This parameter only applies to calibration data. It is ignored for other types of data.
ROTATE	Determines if the output image needs to be rotated 180 degrees clockwise (flipped top to bottom). If the ROTATE parameter is set to YES, then the input file will be rotated. The default is to NOT rotate the image.