Calculates and compares the radiance of a thermal LANSAT scene to the "ground truth"
radiance as measured by a NOAA buoy. Based on work by Frank Padula and Monica Cook.
If you want to use this code, you should have a basic knowledge of python and/or basic coding.
No warranty. Use it on armstrong or related servers for best results. Developed on Fedora x64 by Nathan Dileas.
Copyright RIT 2015-2016
This code essentially has two funtions: calculating the radiance from the landsat image
provided, and calculating the corresponding ground truth radiance from outside data,
atmospheric (NARR or MERRA-2), NOAA buoy data, and MODTRAN. Use the file controller.py as
a convinient command line interface or the underying class itself, in bin/BuoyCalib.py.
http://scholarworks.rit.edu/theses/2961/ - Padula 08 Thesis
http://scholarworks.rit.edu/theses/8513/ - Cook 14 Thesis
This is the primary atmospheric data source for the project. Height, Temperature,
Humidity as a funtion of Pressure. NCEP Reanalysis data provided by the NOAA/OAR/ESRL
PSD, Boulder, Colorado, USA, from their Web site at http://www.esrl.noaa.gov/psd/
This is the secondary atmospheric data source for the project. Height, Temperature,
Humidity as a funtion of Pressure. It was instituted as a result of the NARR dataset
not being up to date. Until late 2016, the NARR archive only reaches to late 2014.
This is the only source of water temperature information for the project.
./buoy-calib, in this directory. Use the -h option for more information
on flags and options that are available.
./buoy-calib [options] <Landsat_ID>
./buoy-calib -i LC80130332013145LGN00 : Output an image with the location
of the buoy and narr points drawn on it
./buoy-calib -m LE70160382012268EDC00 : Use MERRA data instaed of NARR
./buoy-calib -b 44009 LT50410372011048PAC01 : use a specific NOAA buoy
./buoy-calib -imvr LC80130332013145LGN00 : Output an image, verbose, reprocesss, with MERRA data
./buoy-calib LE70160382012268EDC00 LC80130332013145LGN00 : process more than one scene
The Landsat ID can be any valid ID from landsat 5 or 8 with a level 1 product available.
If there is an error, check earth explorer first. It is frequently down for maitenance.
In future, there may be a tool included with this package to check if the ID is valid before
trying to download. Stay tuned.
tools/to_csv.py: used to compile results quickly and easily.
tools/generate_atmo_figure.py : generate a figure using information from a already processed scene.
test/functional/run_all_scenes.bash: run a batch of scenes. Move it to this directory before use.
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.