Name

---

      IMG_LS

Purpose

---

      Scale 24-bit image value (of HSV) between percentiles 1 and 99 (or specified percentiles).

Category

---

Calling Sequence

---

      out = img_ls(in, [l, u, vlo, vhi])

Inputs

---

      in = input image. in
      l = lower percentile to ignore (def = 1). in
      u = upper percentile to ignore (def = 1). in

Keyword Parameters

---

Keywords

---

        SCALE_ON=[vlo,vhi] Optional values to scale to 0, 1.
          Useful with the returned vlo, vhi to scale multiple
          the same.
        /QUIET Inhibit scaling message.
        NBINS=nb Number of histogram bins to use (def=2000).
        /NOSCALE Do not actually scale the data (returns 0).

Outputs

---

      vlo = img value scaled to 0. out
      vhi = value scaled to 1. out
      out = scaled 24-bit image. out

Common Blocks

---

Notes

---

      Notes: Uses cumulative histogram.

Modification History

---

      R. Sterner, 2010 Feb 11
      R. Sterner, 2010 Feb 15 --- Fixed vlo, vhi for constant image.
      R. Sterner, 2010 May 12 --- Converted arrays from () to [].
  Copyright (C) 2010, Johns Hopkins University/Applied Physics Laboratory
  This software may be used, copied, or redistributed as long as it is not
  sold and this copyright notice is reproduced on each copy made. This
  routine is provided as is without any express or implied warranties
  whatsoever. Other limitations apply as described in the file disclaimer.txt.