############################################################################## # # # ATOVS and AVHRR Preprocessing Package (AAPP) # # Version 6.4 Release Notes # # 22 May 2007 # # # ############################################################################## 1. Package contents ------------------- The following files are contained in this update release (with file sizes in bytes): RELEASE_NOTE_AAPP_6_4.txt 8570 This release note AAPP_update_6_4.tgz 11173547 Source code and data This is an incremental update; users need to have installed version 6.1 and updates 6.2 and 6.3. 2. Purpose ---------- The main purposes of this update are as follows: (i) To support the latest version of the IASI level 1 processor OPS-LRS (version OPS_V3-6-p23456). (ii) Improvements to the processing of IASI global and local data within atovpp. (iii) MetOp calibration parameters update (see note below). (iv) Routine NOAA-15 and NOAA-16 AMSU-B calibration update. (v) Improve robustness of HIRS calibration where HRPT signal is noisy. (vi) Miscellaneous corrections and additions. Note on AMSU/MHS antenna corrections ------------------------------------ EUMETSAT have announced that they intend to apply AMSU/MHS antenna corrections in their global MetOp data distribution. The AAPP "fdf.dat" file has been updated to make these new antenna corrections available. However MetOp users who are already using the data operationally may not wish to use these updated values, and may wish to "undo" the EUMETSAT corrections. Other users will want to be consistent with the EUMETSAT processing. This is now possible through the use of environment variables FDFSAT and FDFVN, which are recognised by the AAPP modules atovin and atovin_antcorr. For example, export FDFSAT=METO-02 export FDFVN=2 will make AAPP use the EUMETSAT (version 2) antenna corrections for MetOp-2 (=MetOp-A). Otherwise AAPP will use the version 1 corrections. A detailed list of changed modules is given in section 5. 3. Installation --------------- 1. Copy the tgz file to your AAPP top directory (i.e. the directory containing AAPP, metop-tools and iasi-tools) 2. Unpack it using the command tar -xvmzf AAPP_update_6_4.tgz or if your system does not support the "-z" option in tar, use gunzip -c AAPP_update_6_4.tgz | tar -xmf - 3. Re-build the package using the commands make clean make A full rebuild is recommended. 4. Version control information ------------------------------ The source package (AAPP_update_6_4.tgz) corresponds to Subversion Revision 85 in the AAPP repository held at the Met Office. 5. Detailed list of changes --------------------------- Key: M=Modified, A=Added, D=Deleted M AAPP/src/calibration/libamsuacl/ama_cal.F Avoid divide by zero error if an instrument is powered off M AAPP/include/hcinit_algoV4.h M AAPP/src/calibration/libhirscl_algoV4/h_cntmn_algoV4.F M AAPP/src/calibration/libhirscl_algoV4/h_slope_algoV4.F M AAPP/src/calibration/libhirscl_algoV4/h_median_algoV4.F M AAPP/src/calibration/libhirscl_algoV4/h_testcoef_algoV4.dat M AAPP/src/calibration/libhirscl_algoV4/h_testcoeffile_algoV4.F M AAPP/src/calibration/libhirscl_algoV4/h_partial_superswath_algoV4.F M AAPP/src/calibration/libhirscl_algoV4/h_BBslopcontrol_algoV4.F Ignore HIRS calibration samples where more than 4 channels have the same counts values. These are likely to be corrupt. Improve diagnostics. M AAPP/src/calibration/libmhscl/mhs_clparams.dat Minor update to MHS cold space corrections (from EUMETSAT) M AAPP/src/calibration/libamsubcl/amsub_clparams.dat AMSU-B gross limits update. NOAA-15 was outside limits for channel 3. M AAPP/src/decommutation/libdecom/amshdu.F Allow the AMSU-A part of the original MetOp test case to run. This had failed with AAPP v6.3. Does not affect post-launch data. M AAPP/src/tools/libf7tp/gdg.F M AAPP/src/tools/libf7tp/ghg.F Improve portability of date/time routines M AAPP/src/tools/libaappbufr/aapp_get_1c.F Create dataqual flags if missing. Fix scaling for AVHRR CGy and CGz in IASI BUFR decode. M AAPP/src/tools/bin/AAPP_RUN_METOP.ksh Update for new OPS-LRS - validated with post-launch IASI data. M AAPP/src/tools/bin/aapp_encodebufr_1c.ksh Add return code M AAPP/src/preproc/libatovin/fdf.dat M AAPP/src/preproc/libatovin/infdf.F Allow user to specify which version of antenna corrections to use, via environment variables FDFSAT and FDFVN. Add v2 corrections for MetOp-2, supplied by EUMETSAT. M AAPP/src/preproc/libatovpp/ppiget.F M AAPP/src/preproc/libatovpp/ppout.F Cope with gaps in IASI data M AAPP/src/preproc/libatovpp/ppamsub2.F Avoid array bounds error when AMSU-B grid requested in atovpp M AAPP/include/iasi1d.h M AAPP/include/ppifdata.h M AAPP/include/ppistore.h M AAPP/src/preproc/libatovpp/ppi1d.F M AAPP/src/preproc/libatovpp/ppifdf.F M AAPP/src/preproc/libatovpp/ppithin.F M AAPP/src/preproc/libatovpp/ppioutd.F M AAPP/src/preproc/libatovpp/ppiouth.F M AAPP/src/preproc/libatovpp/ppiamsu.F A AAPP/src/preproc/libatovpp/ppicloud.F M AAPP/src/preproc/libatovpp/Makefile M AAPP/src/preproc/libatovpp/IASI.fdf Implement IASI cloud detection based on Cheng et. al. (ITSC15 poster A17). Correct format error in IASI l1d. The cloud flag should be for each spot. Provide the ability to exclude "bad" detectors - via IASI.fdf Correct bug in microwave cloud tests, affecting edge of scan M AAPP/src/preproc/libatovpp/IASI_eigenvectors.gz Update IASI eigenvectors. This is labelled version 4 and is from data after the instrument parameters were updated on 2 Apr 2007 M AAPP/src/navigation/libnavnoaa/invlorb.F M AAPP/src/navigation/libnavnoaa/lptoviewvect.F M AAPP/src/navigation/libnavnoaa/viewvecttolp.F M AAPP/src/navigation/libnavnoaa/libnavnoaa.3f M AAPP/src/navigation/libnavnoaa/lptoviewvect_iasi.F M AAPP/src/navigation/libnavnoaa/estimrp.F M AAPP/src/navigation/libnavnoaa/earthloc_iasi.F M AAPP/src/navigation/libnavnoaa/estimatt.F M AAPP/src/navigation/libnavnoaa/invloc.F M AAPP/src/tools/libsatid/genscnam.F M AAPP/src/tools/libsatid/satid.txt M AAPP/src/tools/libsatid/ordtiid.F M AAPP/src/tools/libsatid/convl1binst.F M AAPP/src/tools/libsatid/geninstnam.F M AAPP/src/tools/libsatid/genscid.F M AAPP/src/tools/libsatid/ord1bid.F M AAPP/src/tools/libsatid/geninstid.F M AAPP/src/tools/libsatid/ordavid.F M AAPP/src/preproc/libmappiasi/contour_iasi_avhrr.F M AAPP/src/preproc/libmappiasi/contour_sondeur_avhrr.F Correct several bugs related to misalignment angles. Change the misalignment signs. Add 2 new arguments to invloc.F and invlorb.F. D metop-tools/src/libeps_avhrrl1b_6.5/aapp_avhrrl1b.c M metop-tools/src/libeps_avhrrl1b_6.5/Makefile Delete duplicate aapp_avhrrl1b.c M metop-tools/src/bin/eps_avhrrl1b-main.c Add ORBIT_START & ORBIT_END to MPHR Add CH*_SOLAR_FILTERED_IRRADIANCE, CH*_EQUIVALENT_FILTER_WIDTH, CH*_CENTRAL_WAVENUMBER, CH*_CONSTANT1, CH*_CONSTANT2_SLOPE to GIADR_ANALOG M metop-tools/src/bin/admin-messages.c Do not print null characters M metop-tools/src/libeps_avhrrl1b_6.5/convert_avh1b.F M metop-tools/src/bin/convert_avh1b.ksh Fix channel 3A/3B indicators and relative azimuth angles (when converting PFS format to AAPP format) D iasi-tools/src/bin/compare-iasi-pfs.c M iasi-tools/src/bin/eps_metopl0-obt-xml.c A + iasi-tools/src/bin/compare-iasi-pfs1c.c M iasi-tools/src/bin/Makefile Update IASI tools M iasi-tools/src/libeps_iasil1c_6.6/eps_iasil1c_6.6.c Ignore records with subclass 99 (archive information used in UMARF) M iasi-tools/src/libeps_iasil1c_6.6/convert_iasi1c.intf.c-F M iasi-tools/src/libeps_iasil1c_6.6/convert_iasi1c.F M iasi-tools/src/bin/convert_iasi1c.ksh Change all vinteger4 to distinct scale/value arrays - for big-endian systems. Provide default orbital period if reported velocities are bad. Fix return code. A config/gfortran Configuration file for gfortran compiler (supplied by Davide Cesari)