############################################################################## # # # ATOVS and AVHRR Preprocessing Package (AAPP) # # Version 7.4 Release Notes # # 14 December 2012 # # # ############################################################################## 1. Package contents ------------------- The following files are contained in this update release (with file sizes in bytes): RELEASE_NOTE_AAPP_7_4.txt 5806 This release note AAPP_update_7_4.tgz 44103 AAPP source code This is an incremental update; users need to have downloaded and unpacked version 7.1 (the initial release of AAPP v7) and updates 7.2 and 7.3. 2. Main Changes --------------- - Updates for Metop-B (as posted on the AAPP Forum, Oct 2012) - Updated MAIA2.1 thresholds files for Metop-B - Reject lunar-contaminated ATMS scans (at level 1d) - Tools for working with Multi Mission Administration Messages - Bug fixes (in processing CrIS and FY-3B MWTS/MWHS) and portability fix See section 7 (below) for full details. 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_4.tgz or if your system does not support the "-z" option in tar, use gunzip -c AAPP_update_7_4.tgz | tar -xmf - c. If you have not already done so, either (i) edit ATOVS_ENV7 to add an entry for Metop-B in PAR_NAVIGATION_DEFAULT_LISTESAT and PAR_NAVIGATION_DEFAULT_LISTEBUL, by adding 'M01' and 'tle' to the lists respectively, or (ii) run "configure" (with appropriate options - see Installation Guide) to create a new ATOVS_ENV7. d. Go to the AAPP_7 top directory and type make The above instructions assume you are starting from an existing AAPP v7 installation. If you are starting from scratch, the sequence is (i) unpack AAPP v7.1 and cd to the AAPP top directory, (ii) unpack the update releases 7.2, 7.3 and 7.4 (as in steps a-b above), (iii) run "configure" (see chapter 3.4 of the AAPP Installation Guide), (iv) run "make" and optionally "make install". 4. A note on Multi Mission Administration Messages (MMAM) for Metop-B --------------------------------------------------------------------- The AAPP_RUN_METOP script, for processing direct readout Metop data, assumes that your level 0 files are in a standard format, with time information contained in a VIADR (Variable Internal Auxiliary Data Record). If your Metop-B data does not contain a VIADR, or if it contains incorrect information, you can create or modify it using AAPP tools, from the information in the MMAM (contained withing the HKTM file). If the files you want to process are in the current directory, a typical command sequence is: hktm=$(ls HKTM*Z | head -1) #Expect one HKTM file mmam-main.exe -pfsl0 $hktm mmam.xml.bz2 #Extract the MMAM file from the L0 HKTM bzip2 -df mmam.xml.bz2 #Unzip the MMAM file obtutc=$(print-mmam-obt-utc.pl mmam.xml) #Extract the OBT-UTC time parameters files=$(ls *Z | grep -v HKTM) #L0 files to be processed for file in $files; do patch-level0-from-mmam.exe $obtutc $file #Patch each L0 file rm -f ${file}.old done The MMAMs also contain 2-line element bulletins for various satellites (Metop-A/B; NOAA-15 to 19; NPP). You can print them (or redirect output to a file) using the tool "print-mmam-tle.pl". To run print-mmam-tle.pl or print-mmam-obt-utc.pl, the perl LibXML library needs to be installed on your computer. 5. 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. 6. Version control information ------------------------------ The source package (AAPP_update_7_4.tgz) corresponds to Subversion Revision 344 in the AAPP repository held at the Met Office. 7. Detailed list of changes from v7.3 (r334) to v7.4 (r344) ------------------------------------------------------------- Key: M=Modified, A=Added, D=Deleted Configuration ============= M configure Add M01 to the list of satellites. Tools ===== M AAPP/src/tools/libaappbufr/aapp_get_1c_cris.F M AAPP/src/tools/libaappbufr/aapp_put_1c_cris.F Correct scaling on scalti and surfht M AAPP/src/tools/libaapphdf5/mwhs_sdr_out.F M AAPP/src/tools/libaapphdf5/mwts_sdr_out.F Fix the reading in of channel information for FY-3B Preprocessing ============= M AAPP/src/preproc/bin/cris_channels.F Fix loop ranges M AAPP/src/preproc/libatovpp/map_atms_to_cris.F M AAPP/src/preproc/libatovpp/ppatoutd.F Set ATMS level 1d BTs to missing if the lunar contamination flag is set. Also for ATMS mapped to CrIS. Decommutation and Calibration ============================= M AAPP/src/calibration/libmhscl/mhs_clparams.dat M AAPP/src/decommutation/libdecom/amshdu.F Take account of the fact that MHS FM5 is used for Metop1(B) and FM4 for Metop3(C) MAIA2.1 ======= M AAPP/src/preproc/libavh2hirs_maia_2.1/thresholds.dat Updated Metop-B thresholds files from Meteo-France M AAPP/src/preproc/libmaia_2.1/lec_previ_grib_api.F Avoid the use of "trim" function, for compatibility with g77. metop-tools =========== M metop-tools/src/bin/patch-level0-from-mmam.c Create the VIADR if it is missing M metop-tools/src/bin/Makefile A metop-tools/src/bin/print-mmam-tle.pl Tool to print TLE bulletins from a MMAM message.