mer2pds Documentation

mer2pds - Convert MER flight/calibration images to PDS format
OVERVIEW

This procedure converts ISIS-formatted MER flight/calibration
files to PDS-formatted files.

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 ISIS-formatted MER flight/calibration files to PDS
files:

mer2pds.pl, mer2pds_batch.pl

The mer2pds.pl script will process a single file for each
execution of the script. The mer2pds_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:

mer2pds.pl FROM=from [TO=to] [TRANSTAB=transtab]
   [PDSTMPL=pdstmpl]

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

mer2pds_batch.pl FROM=fromlist [TRANSTAB=transtab]
   [PDSTMPL=pdstmpl]

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, PDSTMPL)
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 '.pds'. If the FROM file is called mer01.cub, then the
default output file will be called mer01.pds. The following example
will process a single file (called mer01.cub), set the translation
table to mercal2pds_translation.def.1, set the PDS template file to
mercal2pds_template.def.1, and let the output file name default:

mer2pds.pl FROM=mer01.cub TRANSTAB=mercal2pds_translation.def.1
PDSTMPL=mercal2pds_template.def.1

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

mer2pds.pl TRANSTAB=mercal2pds_translation.def.1 FROM=mer01.cub
PDSTMPL=mercal2pds_template.def.1


PROCESSING AND ERROR LOGGING

If an error occurs during processing, then mer2pds.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 ISIS filename
 (file extension required)

--

List of input ISIS filenames

--

Output filename
 (default extension is .pds)

--

Name of translation
table file

--

Name of PDS label template
file

--

ADDITIONAL NOTES:

Parm	Description
FROM	This is a ISIS-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 ISIS-formatted files to be processed. The input list must be a single column file that contains one input ISIS 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 ".pds" 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 ".pds" 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 ".pds" appended.
TRANSTAB	This is the translation table to be used by isis2pds for translating ISIS label keywords to PDS label keywords. The default is to use the latest version of the mer2pds_translation.def or mercal2pds_translation.def files in $ISISMERDATA for flight or calibration data.
PDSTMPL	This is the PDS label template file that is used by isis2pds to determine what the output PDS labels will look like. The default is to use the latest version of the mer2pds_template.def or mercal2pds_template.df files in $ISISMERDATA for flight or calibration data.