Calculates and compares the radiance of a thermal LANSAT scene to the "ground truthradiance as measured by a NOAA buoy.
pip install landsatbuoycalib==0.1
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 OVERVIEW: 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. Sources: http://scholarworks.rit.edu/theses/2961/ - Padula 08 Thesis http://scholarworks.rit.edu/theses/8513/ - Cook 14 Thesis NARR: 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/ Website: http://www.esrl.noaa.gov/psd/data/gridded/data.narr.html FTP: ftp://ftp.cdc.noaa.gov/Datasets/NARR/pressure/ MERRA-2: 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. Website: http://gmao.gsfc.nasa.gov/reanalysis/MERRA-2/ FTP: ftp://goldsmr5.sci.gsfc.nasa.gov/data/s4pa/MERRA2/M2I3NPASM.5.12.4/ NOAA: This is the only source of water temperature information for the project. Website: http://www.ndbc.noaa.gov/ Data: http://www.ndbc.noaa.gov/data/stations/station_table.txt http://www.ndbc.noaa.gov/data/stdmet/ http://www.ndbc.noaa.gov/data/historical/stdmet/ USAGE: ./buoy-calib, in this directory. Use the -h option for more information on flags and options that are available. ./buoy-calib [options] <Landsat_ID> Examples: ./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: 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.