##############################################################################
#                                                                            #
#                 ATOVS and AVHRR Preprocessing Package (AAPP)               #
#                        Version 6.7 Release Notes                           #
#                              01 July 2008                                  #
#                                                                            #
##############################################################################

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

  RELEASE_NOTE_AAPP_6_7.txt         4658 This release note
  AAPP_update_6_7.tgz              44735 Source code and data
  INSTGUID.tgz                    142582 Installation Guide

This is an incremental update; users need to have installed version 6.1 and
updates 6.2, 6.3, 6.4, 6.5 and 6.6. Chapter 4 of the Installation Guide has been
updated.


2. Purpose
----------
The main purposes of this update are as follows:

 (i)   Updated calibration parameters
 (ii)  Standardisation of data subtype identification in BUFR encoding
 (iii) Better handling of orbital manoeuvres
 (iv)  Miscellaneous updates
 
  Users of NOAA-16 AMSU-B direct-readout data should implement this update as
  soon as possible, since the calibration view counts of channels 19 and 20 are
  predicted to fall below the old limits during July/August 2008.

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

   or if your system does not support the "-z" option in tar, use
   gunzip -c AAPP_update_6_7.tgz | tar -xmf -
   
c. Go to the AAPP_6 top directory and type
   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_7.tgz) corresponds to Subversion Revision 122
in the AAPP repository held at the Met Office. 


6. Detailed list of changes
---------------------------
Key: M=Modified, A=Added, D=Deleted

M      AAPP/src/calibration/libamsuacl/amsua_clparams.dat
M      AAPP/src/calibration/libamsubcl/amsub_clparams.dat
M      AAPP/src/calibration/libmhscl/mhs_clparams.dat
NOAA-18 AMSU-A2 temperature telemetry has been noisy since 7th Feb 2008.
Update AMSU-B gross limits on NOAA-15 and 16 as instruments drift.
Modify MHS gross limits: space view 1500-28000 and warm view 20000-64881 for all
instruments. Note 64881 is 99% of maximum and is close to the point where
calibration counts start to saturate (as observed in NOAA-18 MHS, 23 March 2008)

M      AAPP/src/calibration/libavhrcl/avh_get.F
Allow calibration of AVHRR files that don't start at 1 (e.g. NOAA LAC from
CLASS, with Geographical selection enabled)

M      aapp_encodebufr_1c.F
Change message type to 3 (vertical soundings). Local subtype defaults to
EUMETSAT convention (HIRS=0, AMSU-A=3, AMSU-B=4, MHS=11, IASI=221) but can be
over-written by environment variable $MESSAGE_SUBTYPE. International subtype
(for BUFR Edition 4) is defined in update to Common Code Table C13 (AMSU-A=3,
AMSU-B=4, HIRS=5, MHS=6, IASI=7). 

M      AAPP/src/navigation/libtbus/tb_ctrl.F
M      AAPP/src/navigation/libspm/spm_ctrl.F
M      AAPP/src/navigation/libtle/tle_ctrl.F
Allow extrapolation limit to be set by environment variable
PAR_NAVIGATION_EXTRAP_LIMIT. Set this to 100 when a MetOp orbital manoeuvre is
announced, and reset to undefined afterwards.

M      AAPP/src/navigation/libnavtool/def_att.F
Allow fourth bulletin category (Spot) to be used in the satid.txt file.

M      AAPP/src/navigation/libnavtool/stations.txt
Add various RARS stations

M      AAPP/src/preproc/libatovpp/ioh1d.F
M      AAPP/src/tools/bin/Makefile
M      AAPP/src/tools/bin/select_hirs1d.F
Allow reading of 1d files generated on systems with opposite endian-ness.

M      AAPP/src/preproc/bin/atovpp.ksh
IASI.fdf should be in directory $DIR_IASI_PREPROC (if defined), not $DIR_PREPROC

M      AAPP/src/calibration/libhirscl/h_calibcoeffile.F
M      AAPP/src/calibration/libhirscl/h_testcoeffile.F
M      AAPP/src/calibration/libhirscl_algoV4/h_calibcoeffile_algoV4.F
M      AAPP/src/calibration/libhirscl_algoV4/h_testcoeffile_algoV4.F
Test for successful opening of calibration coefficient files.