rad2isis Documentation

rad2isis - Convert PDS-formatted Cassini BIDR Radar files to ISIS format
OVERVIEW

This procedure converts PDS-formatted Cassini BIDR Radar
images to ISIS-formatted cube files. The use of this
procedure will take the burden of determining which
translation table (TRANSTAB) to use off of the user. This
procedure will always default to using the latest version
of the $ISISCSSDATA/rad2isis_translation.def translation
table.

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 Cassini BIDR Radar files to ISIS
cubes:

rad2isis.pl, rad2isis_batch.pl

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

rad2isis.pl FROM=from [TO=to] [TRANSTAB=transtab]

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

rad2isis_batch.pl FROM=fromlist [TRANSTAB=transtab]

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) 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 adding the extension '.cub' to the
FROM file. If the FROM file is called ta_ptsim_bidr.lat, then the
default output file will be called ta_ptsim_bidr.lat.cub. The
following example will process a single file (called ta_ptsim_bidr.lat),
set the translation table to rad2isis_translation.def.1, and let the
output file name default:

rad2isis.pl FROM=ta_ptsim_bidr.lat TRANSTAB=rad2isis_translation.def.1

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

rad2isis.pl TRANSTAB=rad2isis_translation.def.1 FROM=ta_ptsim_bidr.lat


PROCESSING AND ERROR LOGGING

If an error occurs during processing, then rad2isis.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, 12 Oct 2004

Input PDS filename
 (file extension required)

--

List of input PDS filenames

--

Output filename
 (default extension is .cub)

--

Name of translation
table file

--

ADDITIONAL NOTES:

Parm	Description
FROM	This is a PDS-formatted Cassini BIDR Radar file. The file extension must be included with the filename. 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. 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 name of the input file with ".cub" appended.
TRANSTAB	This is the translation table to be used by pds2isis for translating PDS label keywords to ISIS label keywords. The default is to use the latest version of the rad2isis_translation.def file in $ISISCSSDATA.