coyote: CGTASSELEDCAP

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.