Input file name. The input file may be of any image data format, except COMPLEX. It may be a single channel or multichannel.
If the keyword ALL is not specified (this is the default case), this is a
list of the output file names, one for each band to be stretched. There should
be one output file for each value listed for the BANDS parameter. Each output
file will contain one channel of data in BYTE format, suitably stretched.
If the keyword ALL has been specified, OUT should contain just one value,
the root name used for all output filenames. In this case, the channel
number is appended to the name given by OUT, to produce each output file name.
For example, if OUT=cuprite9 and the input contains 6 bands, the following six
output files are produced:
cuprite9.1 cuprite9.2 cuprite9.3
cuprite9.4 cuprite9.5 cuprite9.6
Vicar size field for input: Same as (SL,SS,NL,NS) By default, the entire input image is used if these parameters are not entered.
Starting line of input
Starting sample of input
Number of lines from input
Number of samples from input
Under default conditions, if the input file is multichannel, the user must
list the bands to be processed, using the BANDS parameter, and there must be
one output file listed for each band to be processed.
If the user wishes to process all bands, (s)he may specify the 'ALL
keyword. Under these conditions, only one value of OUT is needed, and the
band numbers need not be listed. Each band is processed, with the output
going into a file called by the name given by "OUT", plus the band number as
an extension to the file name. For example, if OUT=dv and the input has
3 bands, the files dv.1, dv.2, and dv.3 are produced.
The band(s) to be stretched. If the input is a single channel dataset, this parameter is defaulted. If the input is a multichannel file, the number of bands listed by this parameter must match the number of output files. If the ALL keyword is used, all bands are processed, and this parameter is ignored.
The desired mean of each output. The default is 127.5. If a value other than 127.5 is used, the number of standard deviations to the high and low saturation points (0 and 255) will not be equal. Caution should be used when specifying a MEAN value not close to 127.5.
SIGMA is the desired number of standard deviations from the mean to be used to span the BYTE data range of 0 to 255. For example, if SIGMA=2.0, then a pixel two standard deviations below the mean will be mapped to 0, and a pixel two standard deviations above the mean will be mapped to 255. All pixel values within this range are scaled linearly between these two endpoints.