%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% NASA MEASURES High Spectral Resolution Emissivity Algorithm V003 - matlab version Created: Eva Borbas, and Michelle Feltz, UW-MAD, SSEC/CIMSS and Glynn Hulley NASA/JPL CONTACT: eva.borbas@ssec.wisc.edu glynn.hulley@jpl.nasa.gov HISTORY: Version v00r04 Dec 11, 2015 Version v00r05 Jan 31, 2016 - PCS of the lab spectra have been updated Version v00r06 July 15, 2016 - update for the latest CAMEL DB (V0.6) Version V001/v01r02 January 28,2017 - update for the latest CAMEL DB (V1.0) Version V001/v01r04 July 12,2018 - 2 additional laboratory sets are added (combined with snow/ice) Version V001/v01r05 July 18,2018 - 14 micron emis has been updated for partially snow covered surfaces Version V001/v01r07 Aug 20,2018 - 14 micron emis has been updated for partially snow covered surfaces Version V002/v02r01 Oct 09,2018 - update for the latest CAMEL DB (V2.1) Version V003/v03r02 Sept 29,2022 - update for the latest CAMEL DB (V3.2) Version V003 Nov 29,2022 - update for the latest CAMEL DB (V003) %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% The package contains a software to calculate High Spectral Resolution emissivity developed under the NASA MEASURES program called: Unified and Coherent Land Surface temperature and Emissivity (LST&LSE) Earth System Data Record (ESDR). The software runs on the version 3.0 (V003) CAMEL emissivity coefficients data. It also contains a sample program for users to understand how to run the algorithm. HSR emissivity can be calculated using the CAMEL 13 hinge points emissivity values or the CAMEL Principal Component Analyses coefficients as input. Note: This algorithm was released to be useful, but without any warranty. %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% Update since V002 (v02r01): data and output directory has benn updated: mfiles/read_CAEL_coef_V003.m - speeded up mfiles/read_CAEL_emis_V003.m mfiles/create_HSRemis_fromCAMELcoef_V003.m mfiles/create_HSRemis_fromCAMELemis_V003.m data/CAMEL_coef_200701_V003.nc data/CAMEL_emis_200701_V003.nc output/orig/Namib_CAMEL_HSRemis_200701_V003.mat output/orig/Namib_CAMEL_HSRemis_200701_V003.png output/orig/Yemen_CAMEL_HSRemis_200701_V003.mat output/orig/Yemen_CAMEL_HSRemis_200701_V003.png output/orig/MadisonW_CAMEL_HSRemis_200701_V003.mat output/orig/MadisonW_CAMEL_HSRemissivity_200701_V003.png version number has been updated in run_MEASUREs_hsremis_test.m %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% Update since V001 (v01r07): data and output directory has benn updated: data/CAMEL_coef_200701_V002.nc data/CAMEL_emis_200701_V002.nc output/orig/Namib_CAMEL_HSRemissivity_200701_V002._v02r01.mat output/orig/Namib_CAMEL_HSRemissivity_200701_V002._v02r01.png two more site cases are added (Yemen and MadisonW) output/orig/Yemen_CAMEL_HSRemissivity_200701_V002_v02r01.mat output/orig/Yemen_CAMEL_HSRemissivity_200701_V002_v02r01.png output/orig/MadisonW_CAMEL_HSRemissivity_200701_V002_v02r01.mat output/orig/MadisonW_CAMEL_HSRemissivity_200701_V002_v02r01.png version number has been updated in run_MEASUREs_hsremis_test.m %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% Update since V001 (v01r04): data and output directory has benn updated: data/CAMEL_coef_200701_V001.nc data/CAMEL_emis_200701_V001.nc output/Namib_CAMEL_HSRemissivity_200701_V001.orig.mat output/Namib_CAMEL_HSRemissivity_200701_V001.orig.png version number has been updated in run_MEASUREs_hsremis_test.m %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% Update since V001 (v01r02): in coef dir, the following additional laboratory datasets are added: pchsr_v9.2.mat pchsr_v11.2.mat pcmodast_v9.2.mat pcmodast_v11.2.mat version9 is the combination of v8 and v12 version11 is the combination of v10 and v12 data and output directory has benn updated: data/CAMEL_coef_200701_V001.nc data/CAMEL_emis_200701_V001.nc output/Namib_CAMEL_HSRemissivity_200701_V001.orig.mat output/Namib_CAMEL_HSRemissivity_200701_V001.orig.png Science code has not been changed!!! %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% Install the package: 1. ftp MEASURES_CAMEL_hsremis_matlab_V003_v03r01.tar.gz from ftp://ftp.ssec.wisc.edu/pub/ICI/MEASURES_hsremis_matlab_algorithm/ 2. unzip (gzip -d) and untar (tar -xvf) it. Software package contains: coef - contains files of laboratory eigenvectors and eigenvalues (matlab format) data - contains MEASURES emissivity and coefficents files for a test month (2007 January) outdir -contains an image and a mat file of the test case result for sanity check mfiles -contains the MEASURES HSR algotihm file structure: main code: run_MEASUREs_hsremis_test.m calls: -read_CAMEL_coef_V003.m -read_CAMEL_emis_V003.m -create_HSRemis_fromCAMELcoef_V003.m -alternate: create_HSRemis_fromCAMELemis_V003.m Test run: 1. go to the mfiles directory 2. start matlab 3. run: run_MEASUREs_hsremis_test.m 4. comparte the result image and mat file in the output directory with the *orig.png and orig.mat file NOTE: HSR emissivity can be calculated using the CAMEL 13 hinge points emissivity values or the CAMEL Principal Component Analyses coefficients as input. MEASURES_CAMEL_hsremis_matlab_V003.tar.gz package contains: coef: pchsr_v8.2.mat pchsr_v9.2.mat pchsr_v10.2.mat pchsr_v11.2.mat pchsr_v12.2.mat pcmodast_v8.2.mat pcmodast_v9.2.mat pcmodast_v10.2.mat pcmodast_v11.2.mat pcmodast_v12.2.mat data: CAMEL_coef_200701_V003.nc CAMEL_emis_200701_V003.nc mfiles: create_HSRemis_fromCAMELcoef_V003.m create_HSRemis_fromCAMELemis_V003.m read_CAMEL_coef_V003.m read_CAMEL_emis_V003.m run_CAMEL_hsremis_test.m output/orig/: Namib_CAMEL_HSRemissivity_200701_V003.mat Namib_CAMEL_HSRemissivity_200701_V003.png Yemen_CAMEL_HSRemissivity_200701_V003.mat Yemen_CAMEL_HSRemissivity_200701_V003.png MadisonW_CAMEL_HSRemissivity_200701_V003.mat MadisonW_CAMEL_HSRemissivity_200701_V003.png