iss2isis Documentation

iss2isis - Convert Vicar-formatted Cassini ISS images to ISIS format
OVERVIEW

This procedure converts Vicar-formatted Cassini ISS NA/WA files
to ISIS-formatted cube 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 Vicar-formatted Cassini ISS files to ISIS cubes:

iss2isis.pl, iss2isis_batch.pl

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

iss2isis.pl FROM=from [TRANSTAB=transtab] [TARGDEF=targdef]
[KERNLST=kernlst] [INSTPARS=inst] [LONSYS=lon] [LATSYS=lat]

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

iss2isis_batch.pl FROM=fromlist [TRANSTAB=transtab]
[TARGDEF=targdef] [KERNLST=kernlst] [INSTPARS=inst] [LONSYS=lon]
[LATSYS=lat]

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, TRANSTAB, TARGDEF,
KERNLST, INSTPARS, LONSYS, LATSYS) 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.

PROCESSING AND ERROR LOGGING

If an error occurs during processing, then iss2isis.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, 14 Apr 2004

Input Vicar filename
 (file extension required)

--

List of input Vicar filenames

--

Name of translation
table file

--

File containing target
definitions

--

File containing kernel list

--

File containing instrument
parameters

--

Longitude system
(180,360)

360

Latitude system
(OCENTRIC,OGRAPHIC)

OGRAPHIC

ADDITIONAL NOTES:

Parm	Description
FROM	This is a Vicar-formatted Cassini ISS NA/WA 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. The output filename will automatically be created by using the 'root' input name with ".lev1.cub" appended.
FROMLIST	This specifies a file that contains a list of Vicar-formatted Cassini ISS NA/WA files to be processed. The input list must be a single column file that contains one input Vicar 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 with ".lev1.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 iss2isis_translation.def file in $ISISCSSDATA.
TARGDEF	This is the target definition file to be used by levinit for acquiring information specific to the target body. The default is to use $ISISDATA/targets/target.def.# where target specifies the target body name (for example, saturn) and # specifies the latest version of the file available.
KERNLST	This is the kernel list file to be used by levinit for acquiring the names and locations of SPICE kernels for the Cassini ISS images.
INSTPARS	This is the instrument parameters file to be used by levinit for obtaining instrument specific information about the Cassini ISS NA/WA instruments.
LONSYS	This is the longitude system that will be used when the output image is processed by other ISIS programs. The valid values are 180 and 360. The default is 360 which implies that longitudes will be in the range 0 to 360 for the image. A longitude system of 180 implies that longitudes will be in the range -180 to 180 for the image.
LATSYS	This is the latitude system that will be used when the output image is processed by other ISIS programs. The valid values are OGRAPHIC and OCENTRIC. The default is OGRAPHIC.