############################################################################## # # # ATOVS and AVHRR Preprocessing Package (AAPP) # # Version 7.9 Release Notes # # 24 Feb 2015 # # # ############################################################################## 1. Package contents ------------------- The following files are contained in this update release (with file sizes in bytes): RELEASE_NOTE_AAPP_7_9.txt 9118 This release note AAPP_update_7_9.tgz 134218 source code AAPP_MAIA4_data_update_7.9.tgz 280810 update to MAIA4 data This is an incremental update; users need to have downloaded and unpacked version 7.1 (the initial release of AAPP v7) and updates 7.2 to 7.8. Alternatively, a full version of 7.9 is also available on the AAPP ftp site. The following user document has been updated on the web site http://www.nwpsaf.eu/deliverables/aapp/index.html :- NWPSAF-MF-UD-002_Software.pdf Software Description The test case MAIA4_test.tgz has been updated on the AAPP ftp site. 2. Main Changes --------------- - Calibration update for Metop-B and NOAA-18 AMSU-A - MAIA version 4.2. This is the cloud mask for VIIRS. Includes the ability to use GFS forecast files as model background. - Correction for re-processing NOAA-6&7 and TIROS-N data. - Corrections to the hdf5 conversion tools. 3. Installation --------------- To update an existing AAPP installation, the procedure is: a. Copy the tgz files to your AAPP top directory (i.e. the directory containing AAPP, metop-tools and iasi-tools) b. Unpack using the command tar -xvmzf AAPP_update_7_9.tgz or if your system does not support the "-z" option in tar, use gunzip -c AAPP_update_7_9.tgz | tar -xmf - c. Go to the AAPP_7 top directory and type make and optionally "make install" if you have a separate installation directory. If you are creating a new installation, the sequence is either: (1a) unpack AAPP v7.1 and cd to the AAPP top directory (1b) unpack the update releases 7.2, 7.3, 7.4, 7.5, 7.6, 7.7, 7.8, 7.9 (as in steps a-b above), OR (1) unpack the full 7.9 release available from the ftp server Then (2) run "configure" (see chapter 3.4 of the AAPP Installation Guide), (3) run "make" (4) If you used the --prefix= option in configure, run "make install" If you are running MAIA4 you need to install the MAIA4 data files. These can be found on the AAPP ftp site in directory "maia_data_files": AAPP_MAIA4_data.tgz AAPP_MAIA4_data_update_7.6.tgz AAPP_MAIA4_data_update_7.9.tgz 4. License ---------- To use this software, users need to have registered for AAPP v7 with the NWP SAF (www.nwpsaf.org), and to have agreed to the terms of the license agreement. 5. Version control information ------------------------------ The source package (AAPP_update_7_9.tgz) corresponds to Subversion Revision 438 in the AAPP repository held at the Met Office. 6. MAIA version 4.2 =================== MAIA version 4.2 is the release of the software after its calibration on several thousand interactive sea and land targets collected during a one year period, and after its validation by a systematic intensive comparison to NWCSAF SEVIRI products during one month, and its comparison to NWCSAF PPS cloud classification and CALIOP cloud data for a set of common passes. This results in the update of some threshold values used in the test series. We also corrected some bugs, cleaned the software, removed some unused routines and added some new functions like cloud phase description, dust and volcanic ash detection, and thin cirrus detection with the 1.3 m channel. We updated some routines to allow running the code on global data and verified the correct run on a complete pass. And we added the possibility in version 4.2 to compute the texture with the neighbouring medium pixels when the imaging channels are not available. GFS forecast files ------------------ In order to use GFS forecast files, you will have to have (in ATOVS_ENV7 for example) a new environment variable: MAIA4_USE_GFS="yes" If this variable is not defined or not equal to "yes" GFS is not used. It is possible to define also: MAIA4_REMOTE_GFS_DIR=url By default the url is set to http://jpssdb.ssec.wisc.edu/cspp_v_2_0/ancillary/ but can be defined to http://jpssdb.ssec.wisc.edu/ancillary/ to process old data. 7. Detailed list of changes from v7.8 (r428) to v7.9 (r438) ----------------------------------------------------------- Key: M=Modified, A=Added, D=Deleted M AAPP/src/calibration/libamsuacl/amsua_clparams.dat M AAPP/src/calibration/libamsuacl/ama_smpmn.F Update Metop-B AMSU channel 5 warm count limits. Allow for noisy NOAA-18 AMSU 9. Bug fix in ama_smpmn.F - was using wrong PLLO for line-to-line check, but no impact when limit is the same for both PLLOs. M AAPP/include/avh1b_c.h M AAPP/src/tools/bin/avhrr_gac_class_to_aapp_a-j.F M AAPP/src/tools/bin/avhrr_lac_class_to_aapp_a-j.F M AAPP/src/tools/bin/avhrr_lac_class_to_aapp_klm.F M AAPP/src/tools/bin/avh1b_to_hdf5.ksh M AAPP/src/tools/bin/convert_to_hdf5.ksh M AAPP/src/tools/libaapphdf5/add_hdf5_attributes.c M AAPP/src/tools/libaapphdf5/avh1b_to_hdf5_f.F M AAPP/src/tools/libaapphdf5/avh1c_to_hdf5_write.c M AAPP/src/tools/libaapphdf5/hrp1b_read.c-F M AAPP/src/tools/libaapphdf5/hrp1b_read_f.F M AAPP/src/tools/libaapphdf5/hrp1b_to_hdf5_write.c Allow number of AVHRR scans to exceed 32767 (limit was 91 minutes of data, now 182 minutes). Fix compilation warnings: "scalti" and "avh_ang" are short integers. Bug fix: in avh1b_to_hdf5, the satellite and solar zenith angles were transposed. In avh1c_to_hdf5_write.c add "scalti" and correct encoding of "btemps" and other short integers. M AAPP/src/preproc/libatovpp/ppsetup.F Correction: WMO satid 706-708 should be TOVS not ATOVS (NOAA-6&7 and TIROS-N) M AAPP/src/tools/bin/Makefile M AAPP/src/tools/bin/avh1c_to_hdf5.c M AAPP/src/tools/bin/hrp1b_to_hdf5.c M AAPP/src/tools/libaapphdf5/Makefile A AAPP/src/tools/libaapphdf5/ioavh1c1d.F Remove dependency on libmaia3_tools (allowing use of f77 compiler) D AAPP/src/maia4/libmaia4/maia_CMa_IceN.F90 D AAPP/src/maia4/libmaia4/maia_ConfTest_2.F90 D AAPP/src/maia4/libmaia4/maia_Thin_Cirrus.F90 A AAPP/src/maia4/libmaia4/maia_Cloud_Phase.F90 A AAPP/src/maia4/libmaia4/maia_Flag_Dust.F90 A AAPP/src/maia4/libmaia4/maia_Flag_ThinCirrus.F90 A AAPP/src/maia4/libmaia4/maia_Flag_VolcanAsh.F90 A AAPP/src/maia4/libmaia4/maia_Inland_Water.F90 A AAPP/src/maia4/libmaia4/maia_Read_PrevConst.F90 M AAPP/src/maia4/bin/maia_Viirs.F90 M AAPP/src/maia4/bin/maia_date.ksh M AAPP/src/maia4/bin/maia_env.ksh M AAPP/src/maia4/libmaia4/Makefile M AAPP/src/maia4/libmaia4/maia.F90 M AAPP/src/maia4/libmaia4/maia_Box_GetTopo.F90 M AAPP/src/maia4/libmaia4/maia_CMa_CD.F90 M AAPP/src/maia4/libmaia4/maia_CMa_CG.F90 M AAPP/src/maia4/libmaia4/maia_CMa_ConfClear.F90 M AAPP/src/maia4/libmaia4/maia_CMa_IceD.F90 M AAPP/src/maia4/libmaia4/maia_CMa_LD.F90 M AAPP/src/maia4/libmaia4/maia_CMa_LN.F90 M AAPP/src/maia4/libmaia4/maia_CMa_LT.F90 M AAPP/src/maia4/libmaia4/maia_CMa_SD.F90 M AAPP/src/maia4/libmaia4/maia_CMa_SG.F90 M AAPP/src/maia4/libmaia4/maia_CMa_SN.F90 M AAPP/src/maia4/libmaia4/maia_CMa_ST.F90 M AAPP/src/maia4/libmaia4/maia_CMa_texture.F90 M AAPP/src/maia4/libmaia4/maia_CT_day.F90 M AAPP/src/maia4/libmaia4/maia_CT_night.F90 M AAPP/src/maia4/libmaia4/maia_Cal_CoxMunk.F90 M AAPP/src/maia4/libmaia4/maia_Cal_Texture.F90 M AAPP/src/maia4/libmaia4/maia_Cloud_Mask.F90 M AAPP/src/maia4/libmaia4/maia_ConfTest.F90 M AAPP/src/maia4/libmaia4/ma