##############################################################################
#                                                                            #
#                 ATOVS and AVHRR Preprocessing Package (AAPP)               #
#                        Version 6.2 Release Notes                           #
#                              10 Nov 2006                                   #
#                                                                            #
##############################################################################

1. Package contents
-------------------
The following files are contained in this update release 
(with file sizes in bytes):

  RELEASE_NOTE_AAPP_6_2.txt         4752 This release note
  AAPP_update_6_2.tgz              69966 Source code

This is an incremental update; users need to have installed version 6.1


2. Purpose
----------
This update contains bug fixes and modifications necessary to process METOP
data - based on experience with METOP data received during the two weeks after
launch.

The update also fixes some minor problems with processing NOAA data, in which
some passes that were processed successfully by AAPP v5.3 were rejected by
AAPP v6.1.

There is also a new tool to apply or remove antenna corrections to level 1c
data, for AMSU and MHS. This is normally done as part of atovin, but for
ingesting global METOP level 1 data (from EUMETSAT) atovin is not run,
therefore the new tool atovin_antcorr can be used instead.
 
A detailed list of changed modules is given in section 4.


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_2.tgz

   or if your system does not support the "-z" option in tar, use
   gunzip -c AAPP_update_6_2.tgz | tar -xmf -

3. Issue 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_2.tgz) corresponds to Subversion Revision 60
in the AAPP repository held by the AAPP manager at the Met Office. 


5. Detailed list of changes
---------------------------
Key: M=Modified, A=Added

M      AAPP/src/navigation/libnavtool/stations.txt
Add Svalbard

M      AAPP/src/tools/bin/AAPP_RUN_METOP.ksh
Corrections and add flags for decom-avhrr

M      AAPP/src/tools/libsatid/satid.txt
Update METOP-A identifier and date

M      AAPP/src/calibration/libhirscl_algoV4/h_scanpos_algoV4.F
Avoid array overflow when HIRS calibrations are bad

M      AAPP/src/calibration/libmhscl/mhs_smpmn.F
Bug fix: reset coldmin, ismin and nmoon every scan

M      AAPP/src/calibration/libavhrcl/avh_clst.F
Avoid divide by zero when IR channels are off

M      AAPP/src/decommutation/bin/chk1btime.F
Relax time consistency criterion when searching for trustworthy time

M      AAPP/src/decommutation/libdecom/cktime.F
Reduce max permissible gap to 2 minutes

M      AAPP/src/decommutation/libdecom/atovdc.F
Correct AMSU times when data are filled

M      AAPP/src/decommutation/libdecom/amshdu.F
Correct instrument IDs for METOP MHS

M      AAPP/src/preproc/libatovin/inamsa.F
M      AAPP/src/preproc/libatovin/inamsb.F
Fill in ama1c_h_vnantennacorr and amb1c_h_vnantennacorr

M      AAPP/src/preproc/libatovin/Makefile
A      AAPP/src/preproc/libatovin/inamsa_antcorr.F
A      AAPP/src/preproc/libatovin/inamsb_antcorr.F
M      AAPP/src/preproc/libatovin/infdf.F
A      AAPP/src/preproc/bin/atovin_antcorr.F
A      AAPP/src/preproc/bin/atovin_antcorr.ksh
M      AAPP/src/preproc/bin/Makefile
New tool "atovin_antcorr" to apply antenna corrections to uncorrected level 1c
data, or to remove unwanted antenna corrections

M      metop-tools/include/mhs-aapp.h
M      metop-tools/include/amsua-aapp.h
M      metop-tools/src/libeps_common/eps_buffer.c
M      metop-tools/src/libmetop_amsua/amsua-aapp.intf.c-F
M      metop-tools/src/libmetop_amsua/amsua-init.F
M      metop-tools/src/libmetop_mhs/mhs-aapp.intf.c-F
M      metop-tools/src/libmetop_mhs/mhs-init.F
M      metop-tools/src/libmetop_common/common-main.c
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
M      metop-tools/src/bin/admin-main.c
Fix problems with data gaps; add flags to allow decommutation of degraded data;
correct 8 sec timing error in AMSU-A and 16 sec timing error in MHS; ignore bad
data at end of L0 file; other miscellaneous corrections.