############################################################################## # # # ATOVS and AVHRR Preprocessing Package (AAPP) # # Version 8.8 Release Notes # # 17 August 2021 # # # ############################################################################## 1. Package contents ------------------- NWP SAF software is normally made available to registered users via the "software downloads" section of the NWP SAF web site (linked from the top bar of https://nwp-saf.eumetsat.int/site/). AAPP updates are available in two forms: (i) as an incremental update, for users who are updating an existing installation, or (ii) as a full release. The incremental update comprises the following files: (sizes in bytes): RELEASE_NOTE_AAPP_8_8.txt 6907 This release note AAPP_update_8_8.tgz 43307 Changed source code files The full release comprises: AAPP_8.8.tgz 11637865 Source code and data files The IASI level 1 processor (OPS-LRS) is available separately. 2. Main Changes --------------- - Files from the patch 8.7.1 - Portability fixes for GCC 8 - DBNet stations update - Bug fix for hirscl_algoV4 (order of channels in hrs_chqualflg) See section 6 for a full list of code changes. This release is OPTIONAL for operational applications. No changes to the output radiances or brightness temperatures. 2.1 Documentation update ------------------------ NWPSAF-MF-UD-003, Data Formats, v8.1 Available at https://nwp-saf.eumetsat.int/site/software/aapp/documentation/ In this revision the definition of hrs_chqualflg has been corrected for hirscl_algoV4 and details have been added for hirs1c_chanqual. 2.2 Test case updates --------------------- metopb_test.tgz: URL updated for IASI auxiliary files. metopb_test_20170725.tgz: An old test case as been re-posted as this had a working HIRS instrument (Metop-B HIRS failed in May 2020). 3. Installation --------------- To assist the installation process, it is recommended that you consult the installation script install_aapp8.sh (see https://nwp-saf.eumetsat.int/site/software/aapp/download/). This will guide you through the installation of all the main libraries that are used by AAPP and OPS-LRS (including ecCodes, BUFRDC, xerces, fftw, flex, gettext). 3.1 Updating an existing AAPP installation ------------------------------------------ To update an existing installation: a. Copy the update release tgz file 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_8_8.tgz or if your system does not support the "-z" option in tar, use gunzip -c AAPP_update_8_8.tgz | tar -xmf - (Note the use of the "m" flag to ensure that newly-unpacked files have today's date and will therefore be processed by make) c. Go to the AAPP_8 top directory and type make and optionally "make install", if you have a separate installation directory. 3.2 Creating a new installation ------------------------------- If you are creating a new installation, the sequence is: (1) unpack the full 8.7 release (2) run "configure" (see chapter 3.3 of the AAPP Installation Guide), (3) run "make" (4) If you used the --prefix= option in configure, run "make install" (5) If you are using locally-installed hdf5/ecCodes libraries, edit your ATOVS_ENV8 file and define DIR_HDF5 and DIR_ECCODES appropriately, according to the instructions near the bottom of the file. If you want to run MAIA, you should download and unpack the necessary data files that are linked from the AAPP downloads web page (https://nwp-saf.eumetsat.int/site/software/aapp/download/). 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 linked from the AAPP downloads web page. 4. License ---------- To use this software, users need to have registered for AAPP v8 with the NWP SAF (https://nwp-saf.eumetsat.int/site/), 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: 8.8 Last Changed Rev: 688 Last Changed Date: 2021-08-02 10:46:12 +0100 (Mon, 02 Aug 2021) 6. Detailed list of changes from v8.7 (r681) to v8.8 ---------------------------------------------------- Key: M=Modified, A=Added, D=Deleted M metop-tools/src/bin/avhrr-main.c Bug fix: dummy lines were being inserted wrongly at each APID change. Slight impact on IASI navigation. [Also in patch 8.7.1] M AAPP/src/navigation/bin/get_tle.ksh M configure Update the default URLs and satellite lists for get_tle. Note that these are listed in ATOVS_ENV8 which is created by "configure". The EUMETSAT "oiswww" server has been retired. [Also in patch 8.7.1] M AAPP/src/tools/bin/prepare_dbnet_bufr_for_gts.ksh Add South African station codes (hbk, nim, lbv, nbo) M AAPP/src/tools/bin/mwri_sdr.ksh Allow lower case fy3d in mwi_sdr script (EUMETSAT request) M AAPP/src/tools_eccodes/libecbufr/eccodes_get_1c_pciasi.F There is logic in the code to ignore an initial partial scan of IASI, if present, but it only covered the first message. Extend so that it checks subsequent messages, in case the encoding was done with more than 1 message per scan. This used to be the case for some DBNet stations, but now that all are using AAPP v8 the modification is of no impact. M AAPP/src/tools/bin/avhrr_gac_class_to_aapp_a-j.F M AAPP/src/tools/bin/avhrr_gac_class_to_aapp_klm.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/hirs2_class_to_aapp.F Replace division by Z'nnnn' (BOZ literal constant) with division by INT(Z'nnnn'), for compatibility with GCC 10 M metop-tools/include/common-aapp.h Declare aapp_avh1bhd_addr and aapp_avh1bdt_addr as extern for compatibility with GCC 10. See https://gcc.gnu.org/gcc-10/porting_to.html M AAPP/src/tools/bin/AAPP_RUN_METOP.ksh File name check: only run patch-level0-from-mmam.exe on level 0 files M AAPP/src/calibration/libhirscl_algoV4/h_uphrs1bcommon1_algoV4.F Bug fix: Correct the order of channels in hrs_chqualflg in level 1b output files from hirscl_algoV4. It should be l1b order (1,17,2,etc.) but was l1c order (1,2,3,etc.). This meant that it was also wrong in level 1c.