############################################################################## # # # ATOVS and AVHRR Preprocessing Package (AAPP) # # Version 8.6 Release Notes # # 12 August 2020 # # # ############################################################################## 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_6.txt 7821 This release note AAPP_update_8_6.tgz 71428 Changed source code files The full release comprises: AAPP_8.6.tgz 11632734 Source code and data files The IASI level 1 processor (OPS-LRS) is available separately. 2. Main Changes --------------- - Tool to fill in orbit number if it is missing in Metop L0 files. Activated, if required, by setting environment variable: export CHECK_L0_ORBIT=Y. - Add some new DBNet stations in the prepare_dbnet_bufr_for_gts.ksh script. - Support for HIRAS in the "convert_to_hdf5" tool. - Bug fixes: prevent array overflow in atovpp; define DIR_HIRAS_PREPROC; fix an issue in avh_get_vis_coefs.ksh; ensure HIRS 1d and IASI 1d headers report the correct number of scans. - Allow for characteristics of EUMETSAT global ATOVS data (scan numbering) and SNPP ATMS data (quality flags). - Ensure AVHRR raw counts are in range 0 to 1023. See section 6 for a full list of code changes. 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.6.tgz or if your system does not support the "-z" option in tar, use gunzip -c AAPP_update_8.6.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.6 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.6 Last Changed Rev: 674 Last Changed Date: 2020-08-04 10:54:51 +0100 (Tue, 04 Aug 2020) 6. Detailed list of changes from v8.5 (r665) to v8.6 ---------------------------------------------------- Key: M=Modified, A=Added, D=Deleted M AAPP/include/pphstore.h M AAPP/include/ppistore.h M AAPP/src/preproc/libatovpp/pphoutd.F M AAPP/src/preproc/libatovpp/pphouth.F M AAPP/src/preproc/libatovpp/ppioutd.F M AAPP/src/preproc/libatovpp/ppiouth.F M AAPP/src/preproc/libatovpp/ppout.F In atovpp, set hrs1d_h_scnlin and iasi1d_h_scnlin correctly according to the actual number of records written. M AAPP/src/preproc/libatovpp/ppiget.F M AAPP/src/preproc/libatovpp/ppipcget.F Prevent a possible array overflow error that can cause atovpp to go into an infinite loop. M AAPP/src/preproc/bin/atovpp.ksh Bug fix: DIR_HIRAS_PREPROC goes with HIRAS_FDF A AAPP/src/preproc/bin/ama1d_to_hirs1d.ksh M AAPP/src/preproc/bin/Makefile Add ama1d_to_hirs1d calling script, which had been omitted from AAPP v8.5 M AAPP/src/tools/bin/prepare_dbnet_bufr_for_gts.ksh Add sbl, cho, lea stations M AAPP/src/tools/bin/avh_get_vis_coefs.ksh Workaround for problem in which downloaded files would never be updated if they were accessed more than once per day. A AAPP/include/hiras1c_c.h M AAPP/src/tools/bin/Makefile M AAPP/src/tools/bin/convert_to_hdf5.ksh A AAPP/src/tools/bin/hiras1c_to_hdf5.c M AAPP/src/tools/libaapphdf5/Makefile A AAPP/src/tools/libaapphdf5/hiras1c_read.c-F A AAPP/src/tools/libaapphdf5/hiras1c_read_f.F A AAPP/src/tools/libaapphdf5/hiras1c_to_hdf5_write.c Add HIRAS support in convert_to_hdf5. M AAPP/src/tools/bin/AAPP_RUN_METOP.ksh A AAPP/src/tools/bin/patch_l0_orbit.ksh Optional environment variable CHECK_L0_ORBIT invokes an extra check for missing orbit number variables in the L0 files. M AAPP/src/tools_eccodes/libecbufr/eccodes_get_1c_amsua.F M AAPP/src/tools_eccodes/libecbufr/eccodes_get_1c_amsub.F M AAPP/src/tools_eccodes/libecbufr/eccodes_get_1c_hirs.F M AAPP/src/tools_eccodes/libecbufr/eccodes_get_1c_iasi.F M AAPP/src/tools_eccodes/libecbufr/eccodes_get_1c_pciasi.F EUMETSAT global BUFR files have a scan 0. Add 1 for consistency with the rest of AAPP, when processing BUFR data with originating centre 254 and subcentre 0. For HIRS, allow for cases where fieldOfViewQualityFlagsForAtovs is missing (this is the case for EUMETSAT's global data). M AAPP/src/tools/libaappbufr/aapp_get_1c_atms.F M AAPP/src/tools_eccodes/libecbufr/eccodes_get_1c_atms.F Ignore QF9 (granulequal bit 2), which is now often being set for S-NPP ATMS. Accept data when bits 1, 2, 6 or 7 are set. M AAPP/src/calibration/libavhrcl/avh_lbc.F M AAPP/src/decommutation/libdecom/avhrdc.F Make sure avh_video is in range 0 to 1023, and avoid array out of bounds error when processing a file containing negative values. M AAPP/src/maia4/bin/maia4_Avhrr.ksh Allow maia4_Avhrr to run on systems that don't have /usr/bin/time M AAPP/src/maia4/bin/VIIRS_CRIS_MAIA4_RUN.ksh Add a test to check compatibility of "nagg" with CrIS FSR. Recommend to use the version of nagg that is bundled with CSPP SDR v3.1 or later (directory $CSPP_SDR_HOME/common/local/bin).