Name

---

      GAUSSSCL

Purpose

---

      This is a utility routine to perform a gaussian gray-level pixel
      transformation stretch on a image.

Author

---

      FANNING SOFTWARE CONSULTING
      David Fanning, Ph.D.
      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

Category

---

      Utilities

Calling Sequence

---

      scaledImage = GAUSSSCL(image)

Arguments

---

      image: The image to be scaled. Written for 2D images, but arrays
                      of any size are treated alike.

Keywords

---

      SIGMA: The sigma value or width of the Gaussian
                      function. Set to 1 by default.
      MAX: Any value in the input image greater than this value is
                      set to this value before scaling.
      MIN: Any value in the input image less than this value is
                      set to this value before scaling.
      NEGATIVE: If set, the "negative" of the result is returned.
      OMAX: The output image is scaled between OMIN and OMAX. The
                      default value is 255.
      OMIN: The output image is scaled between OMIN and OMAX. The
                      default value is 0.

Return Value

---

      scaledImage: The output, scaled into the range OMIN to OMAX. A byte array.

Common Blocks

---

      None.

Examples

---

      LoadCT, 0 ; Gray-scale colors.
      image = cgDemoData(11) ; Load image.
      TV, GaussScl(image)

Restrictions

---

    Requires SCALE_VECTOR from the Coyote Library:
        http://www.idlcoyote.com/programs/scale_vector.pro

Modification History

---

      Written by: David W. Fanning, 5 September 2007.
      Now setting NAN keyword on all MIN and MAX functions. 2 Dec 2011. DWF.