coyote: CGGAUSSSCL

Description
This is a utility routine to perform a gaussian gray-level pixel transformation 
stretch on an image.
Categories
Image Processing
Returns
A byte scaled image is returned.
Params
image: in, required
   The image to be scaled. Written for 2D images, but arrays of any size are treated alike.
Keywords
max: in, optional
     Any value in the input image greater than this value is set to this value 
     before scaling.
min: in, optional                      
     Any value in the input image less than this value is set to this value
     before scaling.
negative, in, optional, type=boolean, default=0
     If set, the "negative" of the result is returned.
omax: in, optional, type=byte, default=255
     The output image is scaled between OMIN and OMAX. 
omin: in, optional, type=byte, default=0
     The output image is scaled between OMIN and OMAX. 
sigma: in, optional, type=float, default=1.0
    The sigma value or width of the Gaussian function. 
Examples
Display a Gaussian scaled image::
  cgLoadCT, 0              ; Gray-scale colors.
  image = cgDemoData(11)   ; Load image.
  cgImage, cgGaussScl(image)
Author
FANNING SOFTWARE CONSULTING::
    David W. Fanning
    1645 Sheely Drive
    Fort Collins, CO 80526 USA
    Phone: 970-221-0438
    E-mail: david@idlcoyote.com
    Coyote's Guide to IDL Programming: http://www.idlcoyote.com
History
Change History::
  Written by:  David W. Fanning, 5 September 2007.
  Now setting NAN keyword on all MIN and MAX functions. 2 Dec 2011. DWF.
  Renamed cgGaussScl from the retired GaussScl. 26 March 2015. DWF.
Copyright
Copyright (c) 2007-2015, Fanning Software Consulting, Inc.