############################################################################## ATOVS and AVHRR Preprocessing Package (AAPP) Version 8.12 Release Notes 05 October 2023 ############################################################################## 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_v8.12.txt 6511 This release note AAPP_update_8_12.tgz 40568 Changed files The full release comprises: AAPP_8.12.tgz 24822203 Source code and data files The IASI level 1 processor (OPS-LRS) is available separately. 2. Main Changes --------------- 2.1 Summary of changes ---------------------- - AMSU-A calibration updates for N15, N18, N19, M01 and M03. - DBNet station updates. - Add JPSS-2 and FY-3E to satid.txt (used for satellite position and tracking functions). - Correct the satellite instrument codes in level 1d BUFR encoding for MWHS-2, MWTS-2 and MWTS-3. See section 6 for a full list of code changes. In addition, the AAPP code has been moved from a Subversion repository to a Git repository. Whilst this process is largely transparent to users, there are small changes to the version identifiers in individual files and in the AAPP_version.txt file. 2.2 Impact ---------- The AMSU-A calibration update is necessary for successful processing of Metop-B direct broadcast data, otherwise some AMSU channels will be uncalibrated. It is recommended that users either install this release as soon as possible, or at least install the amsua_clparams.dat which can be downloaded from https://nwp-saf.eumetsat.int/downloads/aapp_data_files/atovs_cal_files/ 2.3 Documentation updates ------------------------- None. 2.4 Test case updates --------------------- None. 2.5 Data file updates --------------------- None. 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, kai). 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_12.tgz or if your system does not support the "-z" option in tar, use gunzip -c AAPP_update_8_12.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 clean make and optionally "make install", if you have a separate installation directory. (Note that "make clean" is needed because some of the include files have changed) 3.2 Creating a new installation ------------------------------- If you are creating a new installation, the sequence is: (1) unpack the full 8.12 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.12 2023-10-03 16:24:59 +0000 Commit: 1e86170a7dbb55e95b85097a9dbf3883747fea48 6. Detailed list of changes from v8.11 to v8.12 ----------------------------------------------- Key: M=Modified, A=Added, D=Deleted M AAPP/src/calibration/libamsuacl/amsua_clparams.dat Update gross limits for AMSU-A: N18 channel 8; N19 channel 1; M01 channels 1, 3, 5, 6; M03 channels 4, 8. Remove antenna position check for NOAA-15 AMSU-A2. This antenna position sensor is no longer delivering useful data, though the antenna itself is rotating correctly. M AAPP/src/tools/bin/prepare_dbnet_bufr_for_gts.ksh Add satellites noaa21 and fy3e. Add stations hyd and cay. Add hkg from NOAA. M AAPP/src/tools/libsatid/satid.txt Add JPSS-2 and FY-3E to satid.txt M AAPP/src/tools_eccodes/libecbufr/eccodes_put_1d_mwhs2.F M AAPP/src/tools_eccodes/libecbufr/eccodes_put_1d_mwts2.F M AAPP/src/tools_eccodes/libecbufr/eccodes_put_1d_mwts3.F Correct the values of satelliteInstruments in the MWHS and MWTS level 1d encoders M AAPP/src/tools_eccodes/libecbufr/eccodes_get_1c_mwts3.F Correct bug in L1c labelling of MWTS instrument from 20 to 21. In addition, the "Id" strings in the file headers have been updated following the migration from Subversion to Git. Whilst the format of these comment lines has changed slightly, in most cases the commit dates have not. They do not affect the running of the software.