############################################################################## # # # ATOVS and AVHRR Preprocessing Package (AAPP) # # Version 8.11 Release Notes # # 01 February 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_8_11.txt 6884 This release note AAPP_update_8_11.tgz 61758 Changed files The full release comprises: AAPP_8.11.tgz 24865193 Source code and data files The IASI level 1 processor (OPS-LRS) is available separately. 2. Main Changes --------------- - AMSU-A calibration update for Metop-B. - Allow MAIA to use ECMWF forecast files, available on the ECMWF web site (last 4 days only) - Add VIIRS to CrIS mapping parameters for JPSS-2 (NOAA-21). - Support EUMETSAT's new CCCC codes, to be implemented for EARS stations later in 2023. See section 6 for a full list of code changes. 2.1 Documentation updates ------------------------- None. 2.2 Test case updates --------------------- A routine update has been made to metopizer_and_AAPP.tgz as the information in the README file needed updating. Several of the existing test cases are configured to run MAIA using GFS forecast files (i.e. metopb_test, noaa19_test, MAIA4_test, viirs_to_cris, viirs_cris_maia4_run). However, they cannot be run with automatically-downloaded ECMWF files because ECMWF currently hold only 4 days of forecasts on their web site. Whereas GFS files go back to the beginning of 2018. If you have your own near-real-time data, and want to run with ECMWF fields instead of GFS, you can set this up by environment variables (either in ATOVS_ENV8 or in your calling script): export MAIA4_USE_GFS="no" export MAIA4_USE_ECMWF="yes" export MAIA4_REMOTE_ECMWF_DIR="https://data.ecmwf.int/forecasts" 2.3 Data file updates --------------------- MAIA4 thresholds and atlas files are available at https://nwp-saf.eumetsat.int/downloads/aapp_data_files/maia_data_files/ The AAPP_MAIA4_thresholds_v8.tgz file was updated in November 2022 to support VIIRS on JPSS-2. The AAPP_MAIA4_atlas_extra.tgz file is used to support ECMWF forecast files. The AAPP_MAIA4_atlas.tgz file is unchanged. Unpack each file from the AAPP top directory ($AAPP_PREFIX): tar -xf $file 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_11.tgz or if your system does not support the "-z" option in tar, use gunzip -c AAPP_update_8_11.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.11 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.11 Last Changed Rev: 725 Last Changed Date: 2023-01-05 14:08:54 +0000 (Thu, 05 Jan 2023) 6. Detailed list of changes from v8.10 (r720) to v8.11 ----------------------------------------------------- Key: M=Modified, A=Added, D=Deleted M AAPP/src/calibration/libamsuacl/amsua_clparams.dat Metop-B AMSU-A channel 6 is degrading. Tolerance 18->80 counts, warm view lower limit 14000->13500 counts. M AAPP/src/preproc/libatovpp/mwts3_beamwidth.dat Correction: number of channels is 17 for MWTS-3 M configure M AAPP/src/maia4/bin/maia_env.ksh M AAPP/src/maia4/bin/VIIRS_CRIS_MAIA4_RUN.ksh M AAPP/src/maia4/libmaia4/maia_GetPrev.F90 M AAPP/src/maia4/libmaia4/maia_Read_GribApi.F90 Add option to run MAIA4 with ECMWF model forecast, downloaded from the internet. Controlled by environment variable: export MAIA4_USE_ECMWF=yes Also needs MAIA4_REMOTE_ECMWF_DIR to be defined in ATOVS_ENV8. M AAPP/src/maia4/libmapviirscris/mapping_viirs_cris.fdf Add VIIRS to CrIS mapping parameters for JPSS-2 (NOAA-21) M AAPP/src/tools/bin/prepare_dbnet_bufr_for_gts.ksh For EARS stations, set station-dependent default CCCC values, at the request of EUMETSAT. Allow user to define CCCC as environment variable to allow the defaults to be over-written if required.