############################################################################## # # # ATOVS and AVHRR Preprocessing Package (AAPP) # # Version 7.15 Release Notes # # 23 Feb 2017 # # # ############################################################################## 1. Package contents ------------------- The following files are contained in this update release (with file sizes in bytes): RELEASE_NOTE_AAPP_7_15.txt 8069 This release note AAPP_update_7_15.tgz 111479 source code 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.15. Alternatively, a full version of 7.15 is also available to registered users in the "software downloads" section of the NWP SAF web site http://nwpsaf.eu. 2. Main Changes --------------- - Upgrade VIIRS cloud mask to MAIA v4.4, with enhancements for the CloudMaskQuality field (bit 3/4 of the CloudMask dataset) and a better detection of clouds over cold seas. - Add AAPP version number to l1c BUFR files, also the CSPP version number for ATMS and CrIS. Enabled by default. - Change the method of including NEDT in ATOVS BUFR files - following WMO IPET-DRMM recommendations. Disabled by default. Note: To include NEDT in BUFR products, you can use the "-N" option in aapp_encodebufr_1c. However, we do not recommend that DBNet stations use this operationally until EUMETSAT have implemented the same scheme in their central processing. 3. Installation --------------- 3.1 Updating an existing AAPP installation ------------------------------------------ To update an existing installation: a. Copy the update release 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_15.tgz or if your system does not support the "-z" option in tar, use gunzip -c AAPP_update_7_15.tgz | tar -xmf - c. Go to the AAPP_7 top directory and type cd AAPP; make clean_obj; cd .. make and optionally "make install", if you have a separate installation directory. (The "make clean_obj" step allows you to re-generate executables without deleting data). 3.2 Creating a new installation ------------------------------- If you are creating a new installation, the sequence is either: (1) unpack the full 7.15 release (recommended) OR (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, 7.10, 7.11, 7.12, 7.13, 7.14, 7.15 (as in steps a-b above), 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" To test a new installation, it is recommended to run some of the AAPP test cases, see Chapter 4 of the AAPP Installation Guide. The test cases are normally available on the AAPP web site at http://nwpsaf.eu/site/software/aapp/download/ 4. License ---------- To use this software, users need to have registered for AAPP v7 with the NWP SAF (http://nwpsaf.eu), and to have agreed to the terms of the license agreement. 5. Version control information ------------------------------ Version control information is stored in a AAPP_version.txt file in the top directory ($AAPP_PREFIX). It is generated automatically at the release preparation stage. AAPP_version.txt contains: 7.15 Last Changed Rev: 516 Last Changed Date: 2017-02-20 15:12:15 +0000 (Mon, 20 Feb 2017) 6. Detailed list of changes from v7.14 (r507) to v7.15 (r516) ------------------------------------------------------------- Key: M=Modified, A=Added, D=Deleted M Makefile.PL Add installation of AAPP_version.txt when re-generating the top-level Makefile. . M AAPP/include/atms1c.h M AAPP/include/atms_sdr.h M AAPP/include/cris1c.h M AAPP/include/cris_sdr.h M AAPP/src/tools/libaapphdf5/atms_sdr.intf.c-F M AAPP/src/tools/libaapphdf5/atms_sdr_out.F M AAPP/src/tools/libaapphdf5/atms_sdr_read.c M AAPP/src/tools/libaapphdf5/cris_sdr.intf.c-F M AAPP/src/tools/libaapphdf5/cris_sdr_out.F M AAPP/src/tools/libaapphdf5/cris_sdr_read.c Read the attribute N_Software_Version from the ATMS and CrIS SDR files, and store in the .l1c header record. For example: CSPP_SDR_2_2. Set cris1c_quality to 0, not missing, for consistency with NOAA. This gets written as BUFR descriptor 033003. M AAPP/src/tools/bin/aapp_encodebufr_1c.F M AAPP/src/tools/bin/aapp_encodebufr_1c.ksh M AAPP/src/tools/libaappbufr/aapp_put_1c.F M AAPP/src/tools/libaappbufr/aapp_put_1c_amsua.F M AAPP/src/tools/libaappbufr/aapp_put_1c_amsub.F M AAPP/src/tools/libaappbufr/aapp_put_1c_atms.F M AAPP/src/tools/libaappbufr/aapp_put_1c_cris.F M AAPP/src/tools/libaappbufr/aapp_put_1c_hirs.F M AAPP/src/tools/libaappbufr/aapp_put_1c_iasi.F M AAPP/src/tools/libaappbufr/aapp_put_1c_iras.F M AAPP/src/tools/libaappbufr/aapp_put_1c_mwhs.F M AAPP/src/tools/libaappbufr/aapp_put_1c_mwhs2.F M AAPP/src/tools/libaappbufr/aapp_put_1c_mwri.F M AAPP/src/tools/libaappbufr/aapp_put_1c_mwts.F M AAPP/src/tools/libaappbufr/aapp_put_1c_pciasi.F Append extra BUFR descriptors to hold version information. The AAPP version is appended as an integer (100*major + minor) via descriptor 025060, e.g. 715 for 7.15. In the case of ATMS and CrIS, we also append the SDR software version as a string via descriptor 025061, e.g. "CSPP_SDR_2_2". The extra descriptors are enabled by default for all .l1c and .lpc datasets, but you can disable them using the option "-v none" in aapp_encodebufr_1c. The addition of version information was a request of the DBNet Coordination Group. Change the encoding of NEDT to use class 33 quality descriptors instead of first order stats, as recommended by IPET-DRMM meeting in July 2015. Set default MASTER_TABLE=26 when encoding of NEDT is requested. Add "-s" option to aapp_encodebufr_1c to skip a certain number of scans at start and end of file. for MWHS2, "-s 3" is recommended. M AAPP/src/navigation/libnavtool/stations.txt Add madison to stations.txt M AAPP/src/tools/libaapphdf5/mwri_sdr_out.F Corrections to the MWRI satellite height, position, velocity and orbit angle. (Allow for conical scan, and bug fix in the handling of scan times). M AAPP/src/maia4/bin/maia_Viirs.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_quality.F90 M AAPP/src/maia4/libmaia4/maia_Cal_Texture.F90 M AAPP/src/maia4/libmaia4/maia_Cloud_Pressure.F90 M AAPP/src/maia4/libmaia4/maia_Fill_Input.F90 M AAPP/src/maia4/libmaia4/maia_Fill_Output.F90 M AAPP/src/maia4/libmaia4/maia_PixEnv_reset.F90 M AAPP/src/maia4/libmaia4/maia_Pr_InfoPix.F90 M AAPP/src/maia4/libmaia4/maia_VerifMissing_fields.F90 M AAPP/src/maia4/libmaia4/mod_maia_const.F90 M AAPP/src/maia4/libmaia4IO/maia_IO_Viirs_h5.F90 M AAPP/src/maia4/libmaia4IO/maia_read_Viirs.F90 M AAPP/src/tools/bin/aapp_encodebufr_1c.F M metop-tools/src/bin/aapp1d2pfs.ksh Version 4.4 of maia4, with enhancements for the CloudMaskQuality field (bit 3/4 of the CloudMask dataset) and a better detection of clouds over cold seas. M metop-tools/src/bin/aapp1d2pfs.ksh Add "exit 0" at the end.