# coyote: CGTASSELEDCAP

- coyote/Utilities
- [Source code]

Description

      This function returns an image transformed by tasseled cap coefficients. The number of
      bands returned depends on the shape of the tasseled cap coefficients, but at least three
      bands are always returned: brightness, greenness, and yellowness.

Categories

      Utility

Params

      input: in, required, type=varies
         The input may be either an image to be transformed or the name of an image
         file that can be read with READ_IMAGE (e.g., a GeoTiff file).

Keywords

      display: in, optional, type=boolean
         Set this keyword to display the brightness, greenness, and yellowness band in
         a display window.
      envi: in, optional, type=boolean
        Set this keyword to return the tasseled cap coeficients used by ENVI 4.8.
        These are reported (by ITTVIS) to be for LandSat-5 TM data, although others
        report these are in error for TM-5 data and really apply to TM-4 data.
        Reference: http://www.exelisvis.com/language/en-US/UserCommunity/UserForums/forumid/29/threadid/12985/scope/posts.aspx.
      etm: in, optional, type=boolean
        Set this keyword to return the tasseled cap coeficients proposed by the USGS for
        LandSat-7 ETM+ images. Note that these values should be applied to reflectances.
        Reference: http://landcover.usgs.gov/pdf/tasseled.pdf.
      imagine: in, optional, type=boolean
        Set this keyword to return the tasseled cap coeficients used by the ERDAS Imagine software
        for LandSat-5 data.
      ls4: in, optional, type=boolean
        Set this keyword to return the tasseled cap coeficients reported by Crist, Laurin and Cicone
        for LandSat-4 imagery. Reference: http://www.ciesin.org/docs/005-419/005-419.html.
      ls5: in, optional, type=boolean
        Set this keyword to return the tasseled cap coeficients reported by Crist, Laurin and Cicone
        for LandSat-5 imagery. Reference: http://www.ciesin.org/docs/005-419/005-419.html.
      mss: in, optional, type=boolean
        Set this keyword to return the tasseled cap coeficients originally reported by R.J Kauth and G.S. Thomas
        for MSS LandSat imagery. Reference: http://web.pdx.edu/~jduh/courses/Archive/geog481w07/Students/Marcello_TasselledCap.pdf.
      quickbird: in, optional, type=boolean
        Set this keyword to return the tasseled cap Graham-Schmidt coeficients reportedly used for Quickbird imagery.
        Reference: http://www.asprs.org/a/publications/proceedings/pecora16/Yarbrough_L.pdf
      tm: in, optional, type=boolean
        Set this keyword to return the tasseled cap coeficients originally proposed for TM imagery by Kauth and Thomas.
        Reference: http://web.pdx.edu/~jduh/courses/Archive/geog481w07/Students/Marcello_TasselledCap.pdf.

Examples

      tasselImage = cgTasseledCap('landsatImageFile.tif', /TM, /Display)

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

      Written, 24 August 2012, by David W. Fanning.
      Fixed a dimension problem caused by forgetting a Transpose operation. 17 October 2012. DWF.
      Fixed a type problem with the ETM keyword. 19 October 2012. DWF.

Copyright

      Copyright (c) 2012, Fanning Software Consulting, Inc.