############################################################################## # # # ATOVS and AVHRR Preprocessing Package (AAPP) # # Version 6.3 Release Notes # # 01 Feb 2007 # # # ############################################################################## 1. Package contents ------------------- The following files are contained in this update release (with file sizes in bytes): RELEASE_NOTE_AAPP_6_3.txt 8116 This release note AAPP_update_6_3.tgz 140719 Source code This is an incremental update; users need to have installed version 6.1 and update 6.2 2. Purpose ---------- The main purposes of this update are as follows: (i) To process METOP global data, and to handle the fact that scan line numbers return to zero at the start of each orbit - regardless of the position in the 1c file. (ii) To handle METOP global AVHRR data, in PFS format. A tool is provided to convert to conventional AAPP l1b format - but retaining the scaled radiances of the PFS format. (iii) Add 14 additional monitoring channels to the default IASI channel selection (IASI.fdf). The user is of course free to use his own channel selection if preferred. (iv) For NOAA global data, don't reject the entire orbit if just a few lines have bad times. (v) Tool to account for the fact that EUMETSAT have changed the scaling factor for the OBT/UTC parameters in MetOp admin message. The new scaling factors (from Jan 2007) correspond to the EUMETSAT documentation, however if your reception system follows the old definition then you will need to adjust the level 0 files. See section 5 for details. (vi) Updated AMSU-A calibration parameters file, to take account of elevated noise in NOAA-16 AMSU-A channel 5 and in MetOp-A telemetry. (vii) HIRS instrument temperature converted to K for level 1c file. Previously was in raw telemetry counts. (viii) Insert MetOp-A AVHRR attitude corrections, and reduce the AVHRR scan step, using values provided by EUMETSAT. (ix) Fix the AMSU-B 89GHz range check flag in atovpp. Previously this flag has never been set. (x) Miscellaneous corrections (see below). 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_3.tgz or if your system does not support the "-z" option in tar, use gunzip -c AAPP_update_6_3.tgz | tar -xmf - 3. The IASI level 1d record size has been increased slightly to accommodate additional channels. So assuming you have previously built AAPP and are doing an incremental build, you need to re-build all libatovpp modules: cd AAPP/src/preproc/libatovpp make clean cd ../../../.. 4. Re-build the package using the command make [Note that the use of the -m option in tar ensures that the date of each file is the date of extraction, so "make" re-builds all the changed parts. If you prefer to do a full re-build, type "make clean" first.] 4. Version control information ------------------------------ The source package (AAPP_update_6_3.tgz) corresponds to Subversion Revision 67 in the AAPP repository held by the AAPP manager at the Met Office. 5. Detailed list of changes --------------------------- Key: M=Modified, A=Added, D=Deleted M AAPP/include/iasi1d.h M AAPP/src/preproc/libatovpp/IASI.fdf Update IASI channel selection to add CNES monitoring channels M AAPP/src/calibration/libamsuacl/amsua_clparams.dat Allow for noisy digital telemetry in MetOp-A AMSU-A2 Allow for increased noise in NOAA-16 AMSU-A channel 4 M AAPP/src/calibration/libmhscl/mhs_clparams.dat M AAPP/src/calibration/libmhscl/mhs_cal.F Re-order MHS space corrections for MetOp-A following clarification by EUMETSAT Fix bug that was causing MetOp-A MHS chan 4 space corrections to be used for all MHS channels. M AAPP/src/decommutation/bin/chk1btime.F Fix header end time when last scan has been corrected. Correct number of scans M AAPP/src/decommutation/libdecom/parity.F Avoid possible array bounds error M AAPP/src/decommutation/libdecom/amshdu.F Only update AMSUA instr IDs if non-zero (otherwise can get missing ID in 1b header for MetOp) M AAPP/src/navigation/bin/antcnft.F Correct (start|stop)_conflict offset M AAPP/src/navigation/libspm/spm_ctrl.F M AAPP/src/navigation/bin/spming.F M AAPP/src/navigation/bin/spming.pl Update for Spot orbital bulletins M AAPP/src/preproc/libatovin/inbprc.F M AAPP/src/preproc/libatovin/inhprc.F M AAPP/src/preproc/libatovin/inaprc.F Ignore scans with bad times but do not abort M AAPP/src/preproc/libatovin/inhget.F hrs1c_instrtemp in K; previously in raw counts M AAPP/src/preproc/libatovpp/pphget.F M AAPP/src/preproc/libatovpp/ppbget.F M AAPP/src/preproc/libatovpp/lutmap.F M AAPP/src/preproc/libatovpp/ppaget.F M AAPP/src/preproc/libatovpp/ppiget.F Use estimated scan line for setting scnlinold: for METOP global data the scan line number returns to 1 at start of orbit, which can be in mid-file. M AAPP/src/preproc/libatovpp/ppb2a.F Get the 89GHz range check working: previously this flag was never set. Require all 5 AMSU-B channels to be present, otherwise missing data in just a few channels could cause large corruptions in mapped BT. M AAPP/src/tools/libaappbufr/aapp_put_1c.F M AAPP/src/tools/libaappbufr/aapp_get_1c.F Distinguish between AMSU-B and MHS in code table 002048 Bug fix in encoding: day and month were zero in December Correct hrs1c_mjfrcnt in decoding M AAPP/src/tools/bin/combine_1c.F Accept MHS M AAPP/src/tools/libsatid/satid.txt Adjust AVHRR scan step and misalignment angles as recommended by EUMETSAT D AAPP/gmt/l1d_plot.f A + AAPP/gmt/l1d_plot.F M AAPP/gmt/README.gmt D AAPP/gmt/avhrr_l1b_calib_plot.f A + AAPP/gmt/avhrr_l1b_calib_plot.F D AAPP/gmt/l1d_plot_tovs.f A + AAPP/gmt/l1d_plot_tovs.F D AAPP/gmt/l1d_plot_atovs.f A + AAPP/gmt/l1d_plot_atovs.F Updates to gmt programs for compatibility with AAPP v6 (does not automatically compile, but can be compiled by hand if needed) M metop-tools/src/bin/avhrr-main.c M metop-tools/src/bin/hirs-main.c M metop-tools/src/bin/amsua-main.c M metop-tools/src/bin/mhs-main.c Fix date/time where there are broken lines, so that header is correct M metop-tools/src/libeps_avhrrl1b_6.5/eps_avhrrl1b_6.5.c Cope with GEADR and VEADR records A metop-tools/src/libeps_avhrrl1b_6.5/convert_avh1b.intf.c-F A metop-tools/src/libeps_avhrrl1b_6.5/convert_avh1b.F M metop-tools/src/libeps_avhrrl1b_6.5/Makefile A metop-tools/src/bin/convert_avh1b.c A metop-tools/src/bin/convert_avh1b.ksh M metop-tools/src/bin/Makefile Tool to convert AVHRR PFS 1b to pseudo AAPP 1b (with scaled radiances rather than raw counts) M metop-tools/src/libmetop_common/common-main.c Check change of APID for transition of 3a/3b on AVHRR A metop-tools/src/bin/admin-dump.ksh M metop-tools/src/bin/admin-main.c A metop-tools/src/bin/patch-level0.c A metop-tools/src/bin/patch-level0.ksh M AAPP/src/tools/bin/AAPP_RUN_METOP.ksh Tool to read OBT/UTC parameters from Admin message in the HKTM file and over-write the values in the VIADRs of the instrument level 0 files. Invoke in AAPP_RUN_METOP by including "HKTM" in the list of insruments to be processed. M iasi-tools/src/bin/convert_iasi1c.c M iasi-tools/src/libeps_iasil1c_6.6/convert_iasi1c.intf.c-F M iasi-tools/src/libeps_iasil1c_6.6/convert_iasi1c.F Correct time variable for big-endian platforms M AAPP/src/navigation/libnavtool/stations.txt Add kelburn (New Zealand)