tuple Documentation

tuple - Create list of corresponding DN values from multiple images
OVERVIEW

This procedure creates an output ASCII list of the corresponding DN
values in multiple images. The ASCII list will be formatted so that
all the corresponding DN values for a specific sample,line location
will be stored in one record. For example, the first record in the
list file will contain the DN value for images A, B, and C at the
same sample, line location (for this example, assume sample=1,
line=1):

As1l1 Bs1l1 Cs1l1

Each consecutive record will contain the DN value for images A, B,
and C at the same sample, line within those images:

As2l1 Bs2l1 Cs2l1
As3l1 Bs3l1 Cs3l1

The DN values in each record are always listed in the order that
the images are listed in the FROMLIST file. The above examples
assume that the FROMLIST file lists filename A first, followed by
filename B, and then by filename C.

This procedure can be used to process a single input file or a
list of files. Either way, you will have to provide a file list
containing the name(s) of the files.

PROCESSING WITHOUT USE OF TAE

This procedure provides an interactive interface to the PERL
script that performs the work involved in creating the output
list of corresponding DN values. The PERL script can also be
run standalone. The syntax for running the script from the
command line is:

tuple.pl FROMLIST=fromlist [SFROM=sfrom] [TO=to]

All the parameters in square brackets [] above are optional.
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 (FROMLIST, SFROM, TO)
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 tuple.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, 7 Sept 2004

List of input cube filenames
  (default extension is .cub)

NONE

Input subcube specifier.
NOTE: Put backslash "\"
characters before any
parentheses in the SFROM
string to avoid problems
with the Unix shell.
 (only one band can be
 processed)

--

Output ASCII list file
  (default is fromfile.txt)

--

ADDITIONAL NOTES:

Parm	Description
FROMLIST	This contains a list of ISIS cube filenames. The input list must be a single column file that contains one filename per line. If the extension of the filenames in the list is omitted, then ".cub" will be assumed.
SFROM	Input subcube specifier. The cube2ascii program (which is called by this script) can only process a single band of an image. As a result, the SFROM should only specify a single band. Otherwise, an error will occur. NOTE: Please put a backslash "\" character before any parentheses that occur in your SFROM string. This will avoid problems caused by the Unix shell when the Perl script is called. For example, if you want to use an SFROM of "536-1035(10):331-450(10):1", then you must add backslashes as shown before running tuple: "536-1035\(10\):331-450\(10\):1"
TO	Output ASCII list file. If this file already exists, it will be overwritten by the new data. (default is fromfile.txt)