############################################################################## # # # ATOVS and AVHRR Preprocessing Package (AAPP) # # Version 7.2 Release Notes # # 27 July 2012 # # # ############################################################################## 1. Package contents ------------------- The following files are contained in this update release (with file sizes in bytes): RELEASE_NOTE_AAPP_7_2.txt 6920 This release note AAPP_update_7_2.tgz 153776 AAPP source code AAPP_MAIA3_data_metop01.tgz 39462 Metop-B data files for MAIA3 (copy of Metop-A files) This is an incremental update; users need to have installed version 7.1 (the initial release of AAPP v7). 2. Main Changes --------------- - ATMS pre-processing updates - Tools to process the new Multi-Mission Administration Message (MMAM) - Add data files for Metop-B - NOAA-18 AMSU-A calibration update - Allow user to over-ride the default input file names in atovin and atovpp Note: i) Metop-B data files are subject to update post launch. ii) A MMAM test case "test_mmam.tgz" is available in the "test_cases" directory on the AAPP ftp server. 3. Installation --------------- a. Copy the tgz files 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_7_2.tgz or if your system does not support the "-z" option in tar, use gunzip -c AAPP_update_7_2.tgz | tar -xmf - c. (optional) If you use MAIA3, repeat step b for file AAPP_MAIA3_data_metop01.tgz d. Go to the AAPP_7 top directory and type make Optional note: If you are using a gnu linker (e.g. gfortran), you may wish to consider adding the following linker option in CFLAGS and FFLAGS: "-Xlinker --as-needed". This can be put either in your Makefile.ARCH or in the compiler config file. With this option, external libraries (e.g. hdf5) are only linked in if they are actually needed. 4. License ---------- To use this software, users need to have registered for AAPP v7 with the NWP SAF (www.nwpsaf.org), and to have agreed to the terms of the license agreement. 5. Version control information ------------------------------ The source package (AAPP_update_7_2.tgz) corresponds to Subversion Revision 322 in the AAPP repository held at the Met Office. 6. Detailed list of changes from v7.1 (r315) to v7.2 (r322) ------------------------------------------------------------- Key: M=Modified, A=Added, D=Deleted Preprocessing and tools ======================= M AAPP/include/atms1c.h M AAPP/include/ppcrisstore.h M AAPP/src/tools/libaappbufr/aapp_put_1d_cris.F M AAPP/src/tools/libaappbufr/aapp_put_1d_atms.F M AAPP/src/tools/libaappbufr/aapp_get_1c_atms.F M AAPP/src/preproc/libatovpp/map_atms_to_cris.F M AAPP/src/preproc/libatovpp/ppcoutd.F M AAPP/src/preproc/libatovpp/ppatmsind.F M AAPP/src/preproc/libatovpp/ppatoutd.F Correct scaling of ATMS NEDT values: store as K*1E4 in 1c and 1d files (same as in the hdf5 SDR files). Change atovpp to pass these variables to the 1d output files. M AAPP/src/preproc/libatovpp/ppiind.F Update version number for consistency with iasi1c.h. M AAPP/src/preproc/libatovpp/modify_beamwidth.F For ATMS spatial filtering, treat as missing spots with BT>330K. M AAPP/src/preproc/bin/atovin.ksh M AAPP/src/preproc/bin/atovpp.ksh M AAPP/src/preproc/bin/atovin_antcorr.ksh Allow user to over-ride the default input file names via the "-f" option. M AAPP/include/ppcrisfdata.h M AAPP/src/preproc/libatovpp/ppcrisfdf.F M AAPP/src/preproc/libatovpp/ppcris1d.F Shorten name of "Use_reconstructed_radiances_cris" to less than 32 characters M AAPP/src/tools/libaappbufr/aapp_put_1c.F Allow 6 messages per scan for PCIASI to keep message length <50kb (EARS) M AAPP/src/tools/libaappbufr/aapp_put_1d_iasi.F Change second value of descriptor 002151 from 4 (AMSU-A1-2) to 5 (AMSU-A2) A AAPP/src/tools/bin/atms1c_print_nedt.ksh A AAPP/src/tools/bin/atms1c_print_nedt.F M AAPP/src/tools/bin/Makefile Tool to print out NEDT mean and std dev from an ATMS l1c file. M AAPP/src/preproc/libmaia_2.1/lec_previ_grib_api.F Bug fix in initialisation section. M AAPP/include/cris_sdr.h M AAPP/include/atms_sdr.h Not all systems have stdint.h, so remove this and change 'int32_t' to 'int'. C compilers are not guaranteed to make 'int' 4-byte, but this appears to be the case on all systems that are likely to run AAPP - and is also assumed in metop-tools/include/eps_types.h. Navigation ========== M AAPP/src/navigation/libtle/tle_satpos.F Make orbit numbers from EUMETSAT TLEs consistent with those from NORAD TLEs. Calibration =========== M AAPP/src/calibration/libamsuacl/amsua_clparams.dat NOAA-18 AMSU-A channel 8 warm cal limit 14000->13000 M AAPP/src/calibration/libavhrcl/avh_hdu.F Test avh_h_solarcalyr was not initialised before updating Metop-B ======= M AAPP/src/calibration/libavhrcl/avhcal.txt M AAPP/src/calibration/libhirscl_algoV4/h_calcoef_algoV4.dat M AAPP/src/calibration/libhirscl/calcoef.dat M AAPP/src/preproc/libatovin/fdf.dat M AAPP/src/preproc/libavh2hirs_maia_2.1/thresholds.dat A AAPP/src/preproc/libavh2hirs_maia_2.1/cor_metop01.dat A AAPP/src/preproc/libavh2hirs_maia_2.1/cor_metop01.loc M AAPP/src/preproc/libavh2hirs_maia_2.1/Makefile Add Metop-B Multi Mission Administration Message (MMAM) tools ================================================= M AAPP/src/tools/bin/AAPP_RUN_METOP.ksh A metop-tools/include/metop_mmam.h A metop-tools/src/libmetop_mmam/metop_mmam.c A metop-tools/src/libmetop_mmam/Makefile A metop-tools/src/bin/is-mmam.c A metop-tools/src/bin/mmam-main.c A metop-tools/src/bin/patch-level0-from-mmam.c A metop-tools/src/bin/print-mmam-obt-utc.pl M metop-tools/src/bin/Makefile M metop-tools/Makefile Tools to process the new Multi Mission Administration Message (MMAM): is-mmam.exe test whether a PFSL0 or CCSDS file includes a MMAM message. mmam-main.exe extracts a MMAM compressed bz2 file from a PFSL0 or CCSDS file. print-mmam-obt-utc.pl extracts and prints the OBT UTC correlation parameters. patch-level0-from-mmam.exe changes the VIADR records in a PFSL0 file (can be called from AAPP_RUN_METOP). Note that recent MMAM messages are available at http://oiswww.eumetsat.int/UMS/webapps/metopa/mmams/generated/show/all