Get Data
Revision date: October 11, 2013
Summary:
The Landsat Ecosystem Disturbance Adaptive Processing System (LEDAPS) was a NASA project to map disturbance, regrowth, and permanent forest conversion across the continent (Masek et al., 2006). The LEDAPS processes Landsat imagery to surface reflectance, using atmospheric correction routines developed for the Terra MODIS instrument (Vermote et al., 1997). The original LEDAPS software was developed at NASA GSFC by Eric Vermote, Nazmi Saleous, Jonathan Kutler, and Robert Wolfe with support from the NASA Terrestrial Ecology program (PI: Jeff Masek). This version, Version 2, was adapted by Dr. Feng Gao, and is a stand-alone version of Landsat 1T calibration, TOA reflectance, cloud masking, and atmospheric correction preprocessing chain. The Version 2 LEDAPS software was designed to work with the standard "web enabled" EROS L1T product for Landsat-5 and Landsat-7. Version 2 supports both old and new metadata formats Landsat-7, and supports both historic and current EROS metadata models.i The LEDAPS code is now part of the National Satellite Land Remote Sensing Data Archive at the U.S. Geological Survey (USGS) Earth Resources Observation and Science (EROS) Center, and is and distributed through Git Hub.
This distribution contained the source code, installation and run instructions, and required ancillary data files associated with Version 2. Version 2 and the most recent release can now be downloaded from The Landsat Global Archive Consolidation (LGAC) of USGS EROS at: https://github.com/USGS-EROS/espa-surface-reflectance . The ancillary water vapor and ozone data for 1980 to 2010 from NCEP (National Centers for Environmental Prediction) and TOMS (Total Ozone Mapping Spectrometer) respectively are also available for applicaple supported versions of LEDAPS.
Example of LEDAPS atmospheric correction. (a) Top-of-atmosphere (TOA) reflectance composite (bands 3,2,1) for Landsat-7 ETM+ image of San Francisco Bay (July 7, 1999); (b) Surface reflectance composite. Both images are linearly scaled from p = 0.0 to 0.15. From Masek et al., 2006.
ORNL DAAC VERSION RECORD
| LEDAPS Source Code | ORNL Release Date | Code Start Date | Date Superseded |
|---|---|---|---|
| Version 2 | 2013/02/26 | 2012/09/25 | |
| Version 1 | 2012/04/24 | 2011/11/21 | 2013/02/26 |
Version 2 was updated effective 2012/09/25 and the ancillary data now extends to December 2012.
Version 1 was superseded 2031/02/26. If you would like to obtain Version 1 (Masek et al. 2012), please contact ORNL DAAC User Services (uso@daac.ornl.gov).
Data Citation:
Cite this LEDAPS code as follows:
Masek, J.G., E.F. Vermote, N. Saleous, R. Wolfe, F.G. Hall, F. Huemmrich, F. Gao, J. Kutler, and T.K. Lim. 2013. LEDAPS Calibration, Reflectance, Atmospheric Correction Preprocessing Code, Version 2. ORNL DAAC, Oak Ridge, Tennessee, USA. http://dx.doi.org/10.3334/ORNLDAAC/1146
Model Product Description:
Source Code:
The file ledapsSrc_20120925.tar.gz extrapolates into a subdirectory LedapsSrc_20120925. The code is dated 09/25/2021.
The subdirectory contains the following subdirectories:
bin: Contains the model code
src: Contains the model code
doc: Contains model documentation
readme.txt: contains the installation, run, and test instructions.
release.note: A text file that explains the revisions.
System Requirements:
The LEDAPS software runs on 32-bit or 64-bit Linux OS. The software is a C application that uses versions of Fortran subroutines.
Input Data Sets:
These three files contain the required ancillary data files for running LEDAPS:
1. LedapsAnc_1980-2010.tar.gz:
This file extrapolates into a subdirectory LedapsAnc_1980-2010 which contains the following subdirectories:
a. Subdirectory EP_TOMS:
- 365 or 366 TOMS_YYYYDDD.hdf files where YYYY = year and DDD = day of the year 001 thru 366. All years have 365 days excepts years 1980, 1984, 1988, 1992, 1996, 2000, 2004 and 2008 which have 366 days (i.e. leap years)
- These files are in hdf format.
b. CMGDEM.hdf - a digital elevation model data file
c. Subdirectory REANALYSIS:
- Contains REANALYSIS_YYYYDDD.hdf files where YYYY is the year 1980-2010 and DDD is the day of the year 001 thru 366. All years have 365 days excepts years 1980, 1984, 1988, 1992, 1996, 2000, 2004 and 2008 which have 366 days (i.e. leap years)
- These files are in hdf format.
d. Subdirectory L5_TM: Contains 3 *.dat files.
2. LedapsAnc_2011.tar.gz:
This file extrapolates into a subdirectory LedapsAnc_2011 which contains the following subdirectories:
a. Subdirectory EP_TOMS contains: TOMS_2011DDD.hdf files.
- contains 365 TOMS_YYYYDDD.hdf files where YYYY = 2011 and DDD = day of the year.
- These files are in hdf format.
b. Subdirectory REANALYSIS:
- Contains 365 REANALYSIS_YYYYDDD.hdf files where YYYY = 2011 and DDD = day of the year.
- These files are in hdf format.
3. LedapsAnc_2012.tar.gz:
This file extrapolates into a subdirectory LedapsAnc_2012 which contains the following subdirectories:
a. Subdirectory EP_TOMS:
- Contains 366 TOMS_YYYYDDD.hdf files where YYYY = 2012 and DDD = day of the year.
- These files are in hdf format.
b. Subdirectory REANALYSIS:
- Contains 366 REANALYSIS_YYYYDDD.hdf files where YYYY =2012 and DDD is the day of the year 001 thru 366.
- These files are in hdf format.
LEDAPS Command-line Applications:
LEDAPS consists of four command-line applications, intended to be run in sequence:
- lndpm: extracts metadata from the standard Landsat product, and writes configuration files for the rest of the processing chain. Also outputs ENVI header files.
- lndcal: calibrates Landsat-5 TM and Landsat-7 ETM+ data, and generates top-of-atmosphere reflectance. Also writes TOA brightness temperature file for band 6.
- lndcsm: generates cloud mask using the ACCA (Automated Cloud Cover Assessment) algorithm (Irish et al., 2006).
- lndsr: performs atmospheric correction for the Landsat reflective bands using the Vermote et al. (1997) MODIS/6S radiative transfer approach, with aerosols obtained from the image itself using the Kaufmann et al (1997) "dark dense vegetation" methodology.
Model Output:
Output files for each Landsat image processed include:
- lndcal.*.hdf: top-of-atmosphere (TOA) reflectance in HDF format
- lndth.*.hdf: themal brightness temperature in HDF format
- lndcsm.*.hdf: cloud mask from ACCA algorithm
- lndsr.*.hdf: surface reflectance in HDF format
Each file is also associated with an ENVI header file that contains geographic information.
Data Access:
This data is available through the Oak Ridge National Laboratory (ORNL) Distributed Active Archive Center (DAAC).
Data Archive Center:
Contact for Data Center Access Information:
E-mail: uso@daac.ornl.gov
Telephone: +1 (865) 241-3952
References:
Irish, R., Barker, J., Goward, S., and Arvidson, T., 2006, Characterization of the Landsat-7 ETM+ Automated Cloud Cover Assessment (ACCA) Algorithm, Photogrammetric Engineering & Remote Sensing, 72, 1179-1188.
Kaufman, Y., et al., 1997, The MODIS 2.2 Micron Channel Correlation with Visible Reflectance for use in Remote Sensing of Aerosol, IEEE Trans. Geosci. Remote Sens., 35, 1286-1298.
Masek, J.G., E.F. Vermote, N. Saleous, R. Wolfe, F.G. Hall, F. Huemmrich, F. Gao, J. Kutler, and T.K. Lim. 2012. LEDAPS Landsat Calibration, Reflectance, Atmospheric Correction Preprocessing Code. Model product. Available on-line [http://daac.ornl.gov] from Oak Ridge National Laboratory Distributed Active Archive Center, Oak Ridge, Tennessee, U.S.A. http://dx.doi.org/10.3334/ORNLDAAC/1080
Masek, J.G., E.F. Vermote, N. Saleous, R. Wolfe, F.G. Hall, F. Huemmrich, F. Gao, J. Kutler, and T.K. Lim, A Landsat surface reflectance data set for North America, 1990-2000, Geoscience and Remote Sensing Letters, 3, 68-72, 2006.
Vermote, E.F. et al., 1997, Atmospheric Correction of Visible to Middle-infrared EOS-MODIS Data Over Land Surfaces: Background, Operational Algorithm, and Validation, J. Geophys. Res., 102, 17131-17141.