############################################################################## # # # ATOVS and AVHRR Preprocessing Package (AAPP) # # Version 8.5 Release Notes # # 05 Dec 2019 # # # ############################################################################## 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 http://nwp-saf.eumetsat.int or https://www.nwpsaf.eu/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_5.txt 8862 This release note AAPP_update_8_5.tgz 191629 Changed source code files The full release comprises: AAPP_8.5.tgz 11617747 Source code and data files The IASI level 1 processor (OPS-LRS) is available separately. 2. Main Changes --------------- - Portability fix (Ubuntu). - AMSU and MHS calibration limits updates and allow for degrading channels. - Allow for recent changes to GFS GRIB files. - More support for existing level 1d BUFR sequences in the ecCodes-based encoder. - Improve interpolation of relative azimuth angles for AVHRR l1c.h5 - Bug fixes. Documentation update (see the AAPP "Documentation" web page): NWPSAF-MF-UD-001 Science Description (v8.1) 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://www.nwpsaf.eu/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.5.tgz or if your system does not support the "-z" option in tar, use gunzip -c AAPP_update_8.5.tgz | tar -xmf - 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.5 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" 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://www.nwpsaf.eu/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 (http://www.nwpsaf.eu), 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.5 Last Changed Rev: 665 Last Changed Date: 2019-11-22 08:46:42 +0000 (Fri, 22 Nov 2019) 6. Detailed list of changes from v8.4 (r638) to v8.5 (r665) ----------------------------------------------------------- Key: M=Modified, A=Added, D=Deleted M AAPP/src/maia4/libmaia4/maia_Read_GribApi.F90 MAIA fix for additional fields in GFS GRIB files. M AAPP/src/calibration/libamsuacl/amsua_clparams.dat Update limits for Metop-B AMSU channels 3 and 5 and NOAA-19 channel 8 M AAPP/src/calibration/libmhscl/mhs_clparams.dat Update limits for Metop-A MHS channel 2 M AAPP/src/calibration/libmhscl/mhssetu.F Allow re-calibration of NESDIS MHS 1b data (as is already possible for AMSU) M AAPP/src/preproc/libatovin/fdf.dat M AAPP/src/preproc/libatovin/inhhdr.F M AAPP/src/preproc/libatovin/inmhdr.F Correct bug in which historical data (e.g. NOAA-16) can be assigned the wrong satid when running atovin. M AAPP/src/preproc/libatovpp/ppbind.F M AAPP/src/preproc/libatovpp/ppaind.F Metop-A MHS channel 2 is degrading: do not set Bqc(bit0) if channel 2 missing. Similarly for NOAA-19 AMSU channel 8. M AAPP/src/tools/bin/hirs2_class_to_aapp.F M AAPP/src/tools/bin/msu_class_to_aapp.F When converting TOVS data (HIRS/2 and MSU) from CLASS format to AAPP, allow for cases where the time code is negative. M AAPP/src/preproc/bin/Makefile M AAPP/src/preproc/bin/cris_degrade_fsr.F A AAPP/src/preproc/bin/hiras_degrade_fsr.F A AAPP/src/preproc/bin/hiras_degrade_fsr.ksh M AAPP/src/tools/libaapphdf5/hiras_sdr_out.F New tool hiras_degrade_fsr to convert HIRAS data from FSR to NSR. In cris_degrade_fsr, correct the header words cris1c_h_startchan and cris1c_h_endchan. In hiras_sdr, set the apodisation flag (hiras1c_radianceflgs). A AAPP/src/preproc/bin/ama1d_to_hirs1d.F Tool to convert AMSU-A level 1d to pseudo-HIRS level 1d. Used for many years at the Met Office but more relevant now, since Metop-C does not have a HIRS. M AAPP/src/calibration/libhirscl_algoV4/h_intercept_algoV4.F Bug fix when HCALIB_TT_FLAG is 2 M AAPP/src/tools/bin/Makefile A AAPP/src/tools/bin/prepare_dbnet_bufr_for_gts.ksh Script to rename BUFR files and add headers ready for distribution in DBNet M AAPP/src/tools/libaapphdf5/avh1c_to_hdf5_write.c M AAPP/src/tools/libaapphdf5/hrp1b_to_hdf5_write.c Improve the interpolation of relative azimuth angles when using the full resolution geolocation option. M AAPP/src/tools/libaapphdf5/atms1c_to_hdf5_write.c For ATMS, add top-level attributes warmnedt_average_mK and coldnedt_average_mK (as is already done for AMSU, MHS and HIRS). M AAPP/src/tools/bin/atms_sdr.ksh M AAPP/src/tools/bin/cris_sdr.ksh M AAPP/src/tools/bin/hiras_sdr.ksh M AAPP/src/tools/bin/iras_sdr.ksh M AAPP/src/tools/bin/mwhs2_sdr.ksh M AAPP/src/tools/bin/mwhs_sdr.ksh M AAPP/src/tools/bin/mwri_sdr.ksh M AAPP/src/tools/bin/mwts2_sdr.ksh M AAPP/src/tools/bin/mwts_sdr.ksh Correct the error trap if the executable is not found. M AAPP/src/tools/bin/AAPP_RUN_METOP.ksh If IASI L0 file is a soft link, give ops_process the name of the actual file. M AAPP/src/tools_eccodes/bin/eccodes_encodebufr_1c.F M AAPP/src/tools_eccodes/bin/eccodes_encodebufr_1c.ksh M AAPP/src/tools_eccodes/libecbufr/Makefile M AAPP/src/tools_eccodes/libecbufr/eccodes_get_1c_pciasi.F M AAPP/src/tools_eccodes/libecbufr/eccodes_put_1c_pciasi.F A AAPP/src/tools_eccodes/libecbufr/eccodes_put_1d_cris.F A AAPP/src/tools_eccodes/libecbufr/eccodes_put_1d_hiras.F A AAPP/src/tools_eccodes/libecbufr/eccodes_put_1d_amsub.F A AAPP/src/tools_eccodes/libecbufr/eccodes_put_1d_iasi.F M AAPP/src/tools_eccodes/libecbufr/eccodes_put_1d_hirs.F Add CRIS1D, HIRAS1D and AMSUB1D bufr encoding: outputs consistent with BUFRDC. Add IASI1D, but note that the BUFR sequence had to be modified from the BUFRDC sequence because ecCodes has difficulty with "203" operator. We hope this can be modified later. The ECCODES_DEFINITIONS_PATH is now set automatically if local definitions are needed. M AAPP/src/tools/libaappbufr/aapp_put_1d_mwhs2.F M AAPP/src/tools/bin/aapp_encodebufr_1c.F Add "MWTS2_FIRST_IN_MWHS21D" environment variable: option to swap the order of instruments in output 1d BUFR file. M metop-tools/src/libeps_avhrrl1b_6.5/convert_avh1b.F Correct the avh_h_satid when processing NOAA-19 GAC data in EPS format. M configure Check /bin/ksh exists (required for most of the AAPP scripts). M build_omit Tool to modify the Makefiles to omit parts of AAPP that you are not interested in. Type "./build_omit" to see usage instructions. M iasi-tools/Makefile.proj Change the order of linked libraries to fix problem in which AAPP v8.3 and 8.4 fail to build on Ubuntu when hdf5 libraries are included.