############################################################################## ATOVS and AVHRR Preprocessing Package (AAPP) Version 8.14 Release Notes 20 January 2025 ############################################################################## 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.14.txt 6333 This release note AAPP_update_8_14.tgz 65823 Changed files The full release comprises: AAPP_8.14.tgz 24891880 Source code and data files The IASI level 1 processor (OPS-LRS) is available separately. 2. Main Changes --------------- 2.1 Summary of changes ---------------------- a) Inclusion of code for processing level 1B data from the Arctic Weather Satellite (AWS1), with the facility to re-map channels to a common grid and to create BUFR output. See the AAPP-AWS User Manual (section 2.3). The new code is held in a separate subdirectory and can be built independently from the "core" AAPP. Please note that public test data from AWS1 are not yet available; an AAPP AWS test case will be added at a future date. b) Update amsua_clparams.dat because the Metop-C AMSU-A antenna position check was failing. See https://nwp-saf.eumetsat.int/site/forums/topic/amsu-a-calibration-parameters-october-2024/ c) Accommodate MWHS-2 and MWTS-3 on FY-3F (hdf5 ingest and BUFR encoding). 2.2 Impact on existing products ------------------------------- Prevent Metop-C AMSU-A calibration failures when processing direct broadcast data 2.3 Documentation updates ------------------------- NWPSAF-MO-UD-063 AAPP-AWS User Manual Available at https://nwp-saf.eumetsat.int/site/software/aapp/documentation/ 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_14.tgz or if your system does not support the "-z" option in tar, use gunzip -c AAPP_update_8_14.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.14 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.14 Release date: 2025-01-20 11:25:49 +0000 (Mon, 20 Jan 2025) Commit: 04a2f2fd4859601a17c27fc096a696b3e5473cd2 6. Detailed list of changes from v8.13 to v8.14 ----------------------------------------------- Key: M=Modified, A=Added, D=Deleted A AAPP-AWS/configure_aapp_aws.sh A AAPP-AWS/src/Makefile A AAPP-AWS/src/Makefile.ARCH.in A AAPP-AWS/src/bin/Makefile A AAPP-AWS/src/bin/aws_netcdf_to_bufr_1b.f90 A AAPP-AWS/src/bin/aws_netcdf_to_bufr_1c.f90 A AAPP-AWS/src/libaws/Makefile A AAPP-AWS/src/libaws/aws_append_netcdf.f90 A AAPP-AWS/src/libaws/aws_average.f90 A AAPP-AWS/src/libaws/aws_data_mod.f90 A AAPP-AWS/src/libaws/aws_read_bufr.f90 A AAPP-AWS/src/libaws/aws_read_netcdf.f90 A AAPP-AWS/src/libaws/aws_remap.f90 A AAPP-AWS/src/libaws/aws_write_bufr.f90 A AAPP-AWS/src/libaws/check.f90 A AAPP-AWS/src/libaws/day_to_date.f90 A AAPP-AWS/src/libaws/mwipp_latlon_mod.f90 A AAPP-AWS/src/libaws/mwipp_remapping_mod.f90 A AAPP_version.txt A configure_aapp_aws.sh A run_dependency_checks.sh M AAPP/src/calibration/libamsuacl/amsua_clparams.dat M AAPP/src/tools/bin/prepare_dbnet_bufr_for_gts.ksh M AAPP/src/tools/libaapphdf5/mwhs2_sdr_out.F M AAPP/src/tools/libaapphdf5/mwhs2_sdr_read.c M AAPP/src/tools/libaapphdf5/mwhs_channels.dat M AAPP/src/tools/libaapphdf5/mwts3_sdr_out.F M AAPP/src/tools/libaapphdf5/mwts_channels.dat M configure