Help for FIT3D

PURPOSE:
        FIT3D is a procedure to rescale multiple bands of a 3-D image into
byte format.  The input may be of half, real, integer, or byte format; and 
BIL, BSQ, or BIP organization.  If the keyword 'ALL is used, all bands are 
scaled to the same limits and the output is a single 3-D dataset.  Otherwise,
individual scaling limits are computed for each band and the output bands are
placed in separate datasets.
        By default, the rescaling is done to map the minimum and maximum input
values to 0 and 255, respectively.  Alternatively, the user may choose to make 
the rescaling limits a set number of standard deviations from the mean by 
setting the STDEV parameter to the desired value. 
EXAMPLES:

FIT3D IMG.HALF IMG.BYTE 'ALL 

In this example, the minimum and maximum values in the dataset IMG.HALF are used
to rescale the data output into IMG.BYTE.



FIT3D IMG.HALF (B.1,B.2,B.3,B.4,B.5,B.6) STDEV=2.5 INC=3

In this case, the rescaling limits are computed to be 2.5 standard deviations
from the mean value in each channel.  INC=3 directs HIST to sample every third
line and pixel to gather statistics.  Since there are 6 outputs, only the first
6 bands will be rescaled, if there are more than 6 bands in the input.




FIT3D IMG.HALF (B.101,B.102,B.103,B.104,B.105) SB=101 STDEV=3.0

In this example, 5 bands starting with Band 101 are rescaled individually to
3.0 standard deviation limits.