############################################################################## # # # ATOVS and AVHRR Preprocessing Package (AAPP) # # Version 8.2 Release Notes # # 10 May 2018 # # # ############################################################################## 1. Package contents ------------------- NWP SAF software is normally made available to registered users via the "software downloads" section of the NWP SAF web site http://nwp-saf.eumetsat.int. 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_2.txt 7818 This release note AAPP_update_8_2.tgz 79928 Changed source code files The full release comprises: AAPP_8.2.tgz 11325010 Source code and data files 2. Main Changes --------------- - Support for new BUFR sequences for VASS (the sounder instruments on the FY-3 satellite series). See details in Section 6. - Update the ATMS file that contains channel characteristics, using official NOAA-20 bandwidths from the Calibration Log Book. - Allow for missing time values in ATMS SDR files and BUFR files. - Bug fixes for NOAA-20 ATMS/CrIS BUFR encode/decode - Bug fix for hdf5 encoding of IASI '.lpc' files. - Option to run MAIA_RUN_AVHRR as part of the IASI processing in the AAPP_RUN_METOP script. New test cases at https://nwpsaf.eu/downloads/aapp_data_files/test_cases/ : noaa20_atmscris fy3_vass_gts 3. Installation --------------- 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.2.tgz or if your system does not support the "-z" option in tar, use gunzip -c AAPP_update_8.2.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.2 release (2) run "configure" (see chapter 3.4 of the AAPP Installation Guide), (3) run "make" (4) If you used the --prefix= option in configure, run "make install" 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 normally available on the AAPP web site at http://nwpsaf.eu/site/software/aapp/download/ 4. License ---------- To use this software, users need to have registered for AAPP v8 with the NWP SAF (http://nwp-saf.eumetsat.int), 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.2 Last Changed Rev: 588 Last Changed Date: 2018-05-01 11:36:25 +0100 (Tue, 01 May 2018) 6. Detailed list of changes from v8.1 (r578) to v8.2 (r588) ----------------------------------------------------------- Key: M=Modified, A=Added, D=Deleted M AAPP/include/iras1c.h M AAPP/include/mwhs1c.h M AAPP/include/mwhs21c.h M AAPP/include/mwri1c.h M AAPP/include/mwts21c.h M AAPP/src/tools/libaappbufr/aapp_put_1c_iras.F M AAPP/src/tools/libaappbufr/aapp_put_1c_mwhs.F M AAPP/src/tools/libaappbufr/aapp_put_1c_mwhs2.F M AAPP/src/tools/libaappbufr/aapp_put_1c_mwri.F M AAPP/src/tools/libaappbufr/aapp_put_1c_mwts2.F M AAPP/src/tools/libaappbufr/aapp_put_1d_iras.F M AAPP/src/tools/libaappbufr/aapp_put_1d_mwhs2.F M AAPP/src/tools/libaappbufr/aapp_put_1d_mwri.F M AAPP/src/tools/libaappbufr/aapp_put_1d_mwts2.F M AAPP/src/tools/libaapphdf5/iras_sdr_out.F M AAPP/src/tools/libaapphdf5/mwhs2_sdr_out.F M AAPP/src/tools/libaapphdf5/mwhs_sdr_out.F M AAPP/src/tools/libaapphdf5/mwri_sdr_out.F M AAPP/src/tools/libaapphdf5/mwts2_sdr_out.F M AAPP/src/tools_eccodes/bin/eccodes_encodebufr_1c.ksh M AAPP/src/tools_eccodes/libecbufr/eccodes_get_1c_iras.F M AAPP/src/tools_eccodes/libecbufr/eccodes_get_1c_mwhs2.F M AAPP/src/tools_eccodes/libecbufr/eccodes_get_1c_mwts2.F M AAPP/src/tools_eccodes/libecbufr/eccodes_put_1c_iras.F M AAPP/src/tools_eccodes/libecbufr/eccodes_put_1c_mwhs.F M AAPP/src/tools_eccodes/libecbufr/eccodes_put_1c_mwhs2.F M AAPP/src/tools_eccodes/libecbufr/eccodes_put_1c_mwri.F M AAPP/src/tools_eccodes/libecbufr/eccodes_put_1c_mwts2.F Support the new VASS BUFR sequences - in the eccodes interfaces. For encoding, you can invoke the new sequences using the environment variable "export USE_VASS_SEQUENCE=Y". The script applies the defaults MASTER_TABLE=29, LOCAL_TABLE=1, ORIGINATING_CENTRE=39, which require local table definitions that are provided in ecCodes v2.7.0 (directory definitions/bufr/tables/0/local/1/39/0). When BUFR tables v30 go operational (and are implemented in ecCodes) you will be able to set MASTER_TABLE=30, LOCAL_TABLE=0 and any value of ORIGINATING_CENTRE. You can set any values of CENTRE_ID and SUBCENTRE_ID, which get used in the data section. The sensor data record files for all the FY-3 instruments have a category for "inland water" in the surface type. Previously this was treated as missing value in AAPP. In this version, it is handled correctly and has a distinct code in the new VASS BUFR sequences. Note: VASS data are available to NWP centres via the GTS, with bulletin identifiers: INKXnn BAWX (MWHS-2) INIXnn BAWX (IRAS) Sample data are available as an AAPP test case. M AAPP/src/tools_eccodes/bin/eccodes_encodebufr_1c.F M AAPP/src/tools_eccodes/libecbufr/eccodes_put_1c_crisfsr.F Correct the dataSubCategory and internationalDataSubCategory for CRISFSR M AAPP/src/tools_eccodes/libecbufr/eccodes_put_1c_cris.F When encoding FSR data in the NSR sequence (which is not the baseline), make sure channel number does not go out of range. M AAPP/src/tools/libaapphdf5/atms_channels.dat Delete 2 dummy lines that were left over from testing. Update NOAA-20 bandwidths, based on the information in the calibration log book. M AAPP/src/tools/libaapphdf5/atms_sdr_read.c Compute taioffset from the first valid time, because sometimes the SDR files start with missing time values. M AAPP/src/tools/libaappbufr/aapp_get_1c_atms.F M AAPP/src/tools_eccodes/libecbufr/eccodes_get_1c_atms.F Correct the BUFR decoding routines that read atms_channels.dat. These were failing for NOAA-20. Allow for missing times in the ATMS input l1c file. M AAPP/src/tools/libaapphdf5/iasipc_read_f.F Add reconrad and scores, which had been missed out. M AAPP/src/calibration/libamsuacl/amsua_clparams.dat NOAA-15 AMSU-A2 antenna position sensor has started giving 90 degree errors. M AAPP/src/tools/bin/AAPP_RUN_METOP.ksh For IASI processing, if the environment variable RUN_MAIA is set to "yes", then the cloud fraction and land fraction are computed and included in the output level 1c file. This assumes the user has installed MAIA data files and has access to forecast files.