USGS

Isis 2 Documentation


bandsyn2 Documentation

bandsyn2 - Creates synthetic data
The "bandsyn2" program was designed to be used in the "bndsynprc"
procedure, and is not meant to be used by itself. For a full
description of this program, consult the "bndsynprc" documentation.

PROGRAMMER: Jim Mathews

ParmDescriptionDefault
FROM
Input cube file name
  (default extension is .cub)
NONE
SFROM
Input subcube specifier
" "
TO
Three statistic output cubes
  (default extension is .cub)
NONE
LPFS
LPF cube file names
"lpf12.cub", "lpf13.cub",                           "lpf23.cub"
BANDS
Band numbers to synthesize
1,2,3
BINMODE
Binning mode
  FIXED or AUTO
"FIXED"
MIN
Minimum valid value for each
  of the three input bands.
  Used with BINMODE=FIXED.
0.0,0.0,0.0
MAX
Maximum valid value for each
  of the three input bands
  Used with BINMODE=FIXED.
255.0,255.0,255.0
OTYPE
Output pixel type
 NULL = input type
    1 = 8 bit
    2 = 16 bit
    3 = 32 bit
0
ORANGE
Output min/max data range
0.0,0.0

ADDITIONAL NOTES:

ParmDescription
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.
LPFS
The 3 cube file names from the Low Pass Filter
BANDS
Enter the band numbers of the three bands you would like
synthesized.
BINMODE
Enter the binning mode.  The two valid values are FIXED
and AUTO.  In FIXED mode, the user must input the min
and max pixel values to be binned for each band.  In AUTO
mode, the program will determine the min and max values
in each band and use them as the min and max values to bin.
MIN
Enter the minimum valid value contained in each of the
three input bands.  Three values are required.  This
parameter used for BINMODE=FIXED.
MAX
Enter the maximum valid value contained in each of the
three input bands.  Three values are required.  This
parameter used for BINMODE=FIXED.
OTYPE
Output pixel data type.  Permitted values are:
 NULL = output type is same as input file pixel type
    1 = 8-bit (integer with type conversion parameters)
    2 = 16-bit (integer with type conversion parameters)
    3 = 32-bit (floating point)
When processed data are being written back into the input
file, the output pixel type must be the same as the
existing pixel type in the input file.
ORANGE
Output pixel data range.  If ORANGE is NULL, then the
CORE_BASE and CORE_MULTIPLIER in the output file will be
set to represent the same range of data as the input file.

If OTYPE=1 (8-bit) or OTYPE=2 (16-bit), then the CORE_BASE
and CORE_MULTIPLIER in the output file will be set to values
that allow representing the specified range of output
values.  Output values outside this range will be stored as
a special "representation saturation" value.

The ORANGE parameter is ignored if OTYPE=3 (32-bit) since
the CORE_BASE and CORE_MULTIPLIER are not applicable to
floating point pixel values.

**NOTE** For a more detailed explanation of ORANGE, tutor
the orange.pdf.

Last updated: Jan 31 2005
File: pdfs2.html

Contact us online at the Isis Support Center: http://isisdist.wr.usgs.gov

ISIS Documentation Home Page