bndsynprc Documentation

bndsynprc - Synthesize missing image data for three bands of a cube
The "bndsynprc" procedure is used to synthesize missing data in three
bands of a cube. The procedure will synthesize data in the image areas
which have missing data in one of the bands but contain data in the
other two bands. BNDSYNPRC performs the steps shown below.

The inputs to "bndsynprc" will be three bands from an input cube.  The
output will be a file with missing data synthesized. The input and
output files will be the same bit type.

First, the procedure passes through the three bands in order to obtain
image statistics.  The statistics will determine the density number
relationship among the three bands.  This step will create temporary
statistics cube files.  These files will then be filtered with the
boxfilter program in order to smooth and interpolate values in the file.
This procedure already contains the filtering steps.

Next, "bndsynprc" reads and applies the filtered statistics files to
the three band set to synthesize the missing image data areas.

Programs used in procedure
--------------------------

1) bandsyn1 - This progam passes through the three band set to extract
   the statistics which determines the relationship among the three
   bands. This step creates intermediate cube files which are then
   filtered and interpolated. The bandsyn1 program and PDF file are
   used only in conjunction with the BNDSYNPRC procedure.

2) boxfilter - This program is executed to smooth and interpolate the
   statistics file which holds the relationship among the three
   cube files.

3) ush /bin/rm - removes the temporary cube files as needed.

4) ratio - divides the sum band by the count band in some of the
   intermediate cube files.

5) bandsyn2 - This program passes though the three input bands and
   synthesizes the missing data.

PROGRAMMER:  Jim Mathews, USGS, Flagstaff

Input cube file name
  (default extension is .cub)

NONE

Input subcube specifier

--

Output cube file name
  (default extension is .cub)

NONE

Three bands to synthesize

1,2,3

Binning mode
  Fixed or Auto

"FIXED"

Minimum valid values of the
  three input bands

0,0,0

Maximum valid values of the
  three input bands

255,255,255

Pathname to the work disk

"."

ADDITIONAL NOTES:

Parm	Description
FROM	Input cube file name. If the file extension is omitted, then ".cub" will be assumed.
SFROM	SFROM specifies the subcube using a single string for all three dimensions of the cube. The order of the three dimensions is always "samples:lines:bands". If a dimension is left blank, all the data for that dimension is selected. The default value of NULL for SFROM selects the entire cube. Any application below can be used for any dimension. To select specific data from any dimension: "10-100(3):11,12,15-20:1-10(2)" = This example will select every third sample starting with sample 10 thru 100. It selects lines 11 and 12, and 15-20. It selects every other band, starting with band 1 thru 10. There are special characters that can be used for selecting a subcube efficiently, such as "*","#", and "~". For examples type "help sfrom" in TAE. **NOTE** For more examples and explanation of the many features of the SFROM parameter, tutor the sfrom.pdf or refer to Introduction To ISIS, Section 6, of the ISIS User's Manual **
TO	Output cube file name. If the file extension is omitted, then ".cub" will be assumed.
BANDS	Enter the location of the three bands to be synthesized. This is the location within the input cube NOT the subcube.
BINMODE	There are two types of binning that can be performed on the data; AUTO or FIXED. AUTO will use the full range of "real" pixel values that are mapped into the bins, 1 to 255. FIXED uses the user provided MIN and MAX to determine the set of pixel values that will be mapped into 1 to 255.
MIN	Enter the minimum value for each of the input bands. This parameter should be accurately determined. In order to determine the MIN value for each of the three bands, inspect listings or histograms of the bands.
MAX	Enter the maximum value for each of the input files. This parameter should be accurately determined. In order to determine the MAX value for each of the three bands, inspect listings or histograms of the bands.
WORK	Enter the pathname of a work disk where the temporary cube files can be written to and then deleted when they are no longer needed. The default is your current directory.