############################################################################## # # # ATOVS and AVHRR Preprocessing Package (AAPP) # # Version 6.6 Release Notes # # 07 Feb 2008 # # # ############################################################################## 1. Package contents ------------------- The following files are contained in this update release (with file sizes in bytes): RELEASE_NOTE_AAPP_6_6.txt 7623 This release note AAPP_update_6_6.tgz 5653753 Source code and data This is an incremental update; users need to have installed version 6.1 and updates 6.2, 6.3, 6.4 and 6.5. 2. Purpose ---------- The main purposes of this update are as follows: (i) Incorporation of IASI eigenvectors recomputed using a 6 month training set, and using a PCA software package being developed for the NWP SAF by ECMWF. (ii) Add ability to process direct-readout FY1D data. The AVHRR-like channels are calibrated and written in AVHRR level 1b format. Increase flexibility of script that retrieves Two-Line Elements. (iii) Increase limit on number of AVHRR scan lines that can be processed (useful for EARS-AVHRR) (iv) Miscellaneous corrections (see below). None of the changes in this update should affect routine ATOVS/AVHRR direct-readout processing for NOAA satellites. A detailed list of changed modules is given in section 6. 3. Installation --------------- a. Copy the tgz file to your AAPP top directory (i.e. the directory containing AAPP, metop-tools and iasi-tools) b. Unpack it using the command tar -xvmzf AAPP_update_6_6.tgz or if your system does not support the "-z" option in tar, use gunzip -c AAPP_update_6_6.tgz | tar -xmf - Note that files marked for deletion in section 6 will remain on your file system unless deleted manually. c. A full re-build is recommended. Go to the AAPP_6 top directory and type make clean make 4. License ---------- To use this software, users need to have registered for AAPP v6 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_6_6.tgz) corresponds to Subversion Revision 113 in the AAPP repository held at the Met Office. 6. Detailed list of changes --------------------------- Key: M=Modified, A=Added, D=Deleted M AAPP/include/hrptdc.h M AAPP/include/avhrcl.h Increase max AVHRR scans to 12000, to allow processing of a full EARS-AVHRR pass M AAPP/include/ppifdata.h M AAPP/src/preproc/libatovpp/ppispectra.F M AAPP/src/preproc/libatovpp/ppifdf.F A AAPP/src/preproc/libatovpp/eigenvectors_1B_Jul_Dec_2007.loc A AAPP/src/preproc/libatovpp/iasi_eigenvectors_spec.dat A AAPP/src/preproc/libatovpp/eigenvectors_1B_Jul_Dec_2007.gz M AAPP/src/preproc/libatovpp/IASI.fdf M AAPP/src/preproc/libatovpp/Makefile M AAPP/src/preproc/bin/iasi_eigenvectors.F M AAPP/src/preproc/bin/iasi_eigenvectors.ksh M AAPP/src/preproc/bin/Makefile M AAPP/src/preproc/bin/atovpp.ksh New eigenvectors file generated by the ECMWF PCA package. New 'iasi_eigenvectors_spec.dat' file to specify the type of eigenvectors file, file names, number of PCs to use, version I/D, etc. Note: if you wish to continue to use the old eigenvectors file then edit the spec file as instructed in the comments. Changed default number of PCs to 150 in IASI.fdf (was 300). M AAPP/src/preproc/libatovpp/ppaind.F Extra QC to reject corrupt lines; ignore missing values in NOAA-16 AMSU 4 M AAPP/src/calibration/libhirscl_algoV4/h_testcoeffile_algoV4.F M AAPP/src/calibration/libhirscl_algoV4/h_calibcoeffile_algoV4.F M AAPP/src/calibration/libhirscl/h_calibcoeffile.F M AAPP/src/calibration/libhirscl/h_testcoeffile.F Check coef files were opened successfully. M AAPP/src/tools/libaappbufr/aapp_put_1c.F M AAPP/src/tools/libaappbufr/aapp_get_1c.F M AAPP/src/tools/bin/aapp_decodebufr_1c.F M AAPP/src/tools/bin/Makefile M AAPP/src/tools/bin/aapp_decodebufr_1c.ksh In BUFR encode, correct HIRS channel numbers and allow unused iasi1c_h_startchan and endchan to be set to "missing". In BUFR decode, read fdf.dat file to get nominal satellite heights and periods (used in atovpp). This improves local-global consistency, e.g. for EARS/RARS. Improve handling of missing times for IASI. Update comments giving IASI BUFR descriptor numbers. M AAPP/src/preproc/libmappiasi/ellipse_sondeur_avhrr.F Update call to invloc (should have been in AAPP update 6.4) M config/pgf90 Add directive -DHAS_DATE_AND_TIME D metop-tools/src/libeps_avhrrl1b_6.5/aapp_avhrrl1b.xml Remove duplicate file M metop-tools/src/libeps_avhrrl1b_6.5/convert_avh1b.F Correct 2.5 sample offset in GAC product. Bug fix to correct day number which was one day out since 1 Jan 2008. D iasi-tools/src/bin/compare-iasi-pfs.ksh A + iasi-tools/src/bin/compare-iasi-pfs1c.ksh M iasi-tools/src/bin/Makefile Re-name script to match compare-iasi-pfs1c.exe A iasi-tools/include/eps_iasil1b_6.6.h A iasi-tools/src/bin/convert_iasi1b.c A iasi-tools/src/bin/convert_iasi1b.ksh A iasi-tools/src/libeps_iasil1b_6.6/eps_iasil1b_6.6.c A iasi-tools/src/libeps_iasil1b_6.6/convert_iasi1b.intf.c-F A iasi-tools/src/libeps_iasil1b_6.6/convert_iasi1b.F A iasi-tools/src/libeps_iasil1b_6.6/Makefile A iasi-tools/Makefile Tool to read IASI level 1b EPS files and convert to AAPP 1c format. These files are an intermediate stage of OPS-LRS. The 1b radiances are self-apodised. A new directory iasi-tools/src/libeps_iasil1b_6.6 is created. M AAPP/src/tools/bin/AAPP_RUN_NOAA.ksh A AAPP/src/tools/bin/AAPP_RUN_FY1.ksh M AAPP/src/tools/bin/Makefile M AAPP/src/tools/libsatid/satid.txt M AAPP/src/calibration/libavhrcl/avhsetu.F M AAPP/src/calibration/libavhrcl/Makefile A AAPP/src/calibration/libavhrcl/fy1cal.txt A AAPP/src/calibration/libavhrcl/fy1_cpar.F A AAPP/src/calibration/libavhrcl/fy1_cal.F A AAPP/src/calibration/bin/fy1cl.ksh A AAPP/src/calibration/bin/fy1cl.F M AAPP/src/calibration/bin/avhrcl.ksh M AAPP/src/calibration/bin/Makefile A AAPP/src/decommutation/bin/convert_chrpt.F A AAPP/src/decommutation/bin/convert_chrpt.ksh M AAPP/src/decommutation/bin/Makefile Add capability of processing AVHRR-like channels of the MVISR imager on FY1D satellite. New main program AAPP_RUN_FY1 - run it with no arguments to get usage instructions. It is assumed that the incoming CHRPT file is in packed binary format with 27740 bytes per frame. The accuracy of the calibration is questionable but the imagery is useful for qualitative purposes. Output is in standard AAPP AVHRR level 1b format. TLE are the default orbital elements (since TBUS is not available for FY1). You may need to modify your TLE selection - see below for expanded functionality of get_tle script. M AAPP/src/navigation/bin/get_tle.ksh M configure Add capability of downloading more than one TLE selection and of handling Celestrak pages and Space-Track "favorites" page. For details, see comments in lines 237-252 of "configure" (which sets up your ATOVS_ENV6 file).