httsan / espa-land-surface-temperature Goto Github PK

Release Date: Dec XX, 2015

This application produces Land Surface Temperature products for Landsats 5, and 7.

See the PLACE HOLDER product guide for information about the Land Surface Temeprature products.

• Initial implementation

• ESPA raw binary libraries, tools, and it's dependencies. Found here
• Python 2.7+ and Scipy/Numpy/GDAL
• GDAL 1.11.1
  • The command line tools are utilized for some of the processing steps.

• Required for building this software (For an example see setup-build-environment.sh)

export PREFIX="path_to_Installation_Directory"
export XML2INC="path_to_LIBXML2_include_files"
export XML2LIB="path_to_LIBXML2_libraries"
export ESPAINC="path_to_ESPA_PRODUCT_FORMATTER_include_files"
export ESPALIB="path_to_ESPA_PRODUCT_FORMATTER_libraries"

• Clone the repository and replace the defaulted version(master) with this version of the software

git clone https://github.com/USGS-EROS/espa-land-surface-temperature.git
cd espa-land-surface-temperature
git checkout version_<version>

• Build and install the application specific software

make
make install

See land_surface_temperature.py --help for command line details.

• PATH - May need to be updated to include the following
  • $PREFIX/bin
• ASTER_GED_SERVER_NAME
  • export ASTER_GED_SERVER_NAME="e4ftl01.cr.usgs.gov"
• ASTER_GED_SERVER_PATH
  • export ASTER_GED_SERVER_PATH="/ASTT/AG100.003/2000.01.01/"

This version of the Land Surface Temperature application requires the input products to be in the ESPA internal file format.

The following input data are required to generate the spectral indicies products:

• Top of Atmosphere Reflectance (TOA)
  • TOA products can be generated using the LEDAPS or L8_SR software found in our espa-surface-reflectance project. Or through our ondemand processing system ESPA, be sure to select the ENVI output format.
• Elevation
  • Elevation data is expected to be in the same projection and image dimensions as the TOA products and in the ENVI file format. The filename is also expected be <sceneid>_dem.img: where sceneid is the Landsat Scene ID of the data being processed.
• ASTER GED
  • ASTER GED data can be found here. However it will automatically be retrieved for you as needed and cleaned up.
• North American Regional Reanalysis (NARR)
  • NARR data, it would be best to utilize the lst_aux_data software provided in this project to download and build your own archive for the dates you require.

After compiling the espa-product-formatter libraries and tools, the convert_espa_to_gtif and convert_espa_to_hdf command-line tools can be used to convert the ESPA internal file format to HDF or GeoTIFF. Otherwise the data will remain in the ESPA internal file format, which includes each band in the ENVI file format (i.e. raw binary file with associated ENVI header file) and an overall XML metadata file.

This project is provided by the US Geological Survey (USGS) Earth Resources Observation and Science (EROS) Land Satellite Data Systems (LSDS) Science Research and Development (LSRD) Project. For questions regarding products produced by this source code, please contact the Landsat Contact Us page and specify USGS CDR/ECV in the "Regarding" section. https://landsat.usgs.gov/contactus.php