##############################################################################
#                                                                            #
#                 ATOVS and AVHRR Preprocessing Package (AAPP)               #
#                        Version 6.13 Release Notes                          #
#                             17 June 2010                                   #
#                                                                            #
##############################################################################

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

Required files:
  RELEASE_NOTE_AAPP_6_13.txt          4642 This release note
  AAPP_update_6_13.tgz               84227 AAPP source code

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


2. Main Changes
---------------
- Allow for degradations in NOAA-19 AMSU and MetOp AMSU
- Ensure that missing BTs are never used in re-mapping
- Enhancements to work with the cloud mask
- Tool to clean up 1c files extracted from ECMWF archive
- Portability fixes and bug fixes


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

   or if your system does not support the "-z" option in tar, use
   gunzip -c AAPP_update_6_13.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_13.tgz) corresponds to Subversion Revision 217
in the AAPP repository held at the Met Office. 


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


Decommutation
=============
M      AAPP/src/decommutation/libdecom/msuout.F
M      AAPP/src/decommutation/libdecom/dcsout.F
M      AAPP/src/decommutation/libdecom/amsout.F
M      AAPP/src/decommutation/libdecom/hirout.F
For portability, re-write the currect scan when correcting times of first few
scan lines. (Workaround for suspected bug in Ubuntu/gfortran)

M      AAPP/src/decommutation/bin/unpack_noaa_hrpt.F
Add svn Id property (no change to code)


Calibration
===========
M      AAPP/src/calibration/libamsuacl/amsua_clparams.dat
Update gross limits for MetOp AMSU 7 and NOAA-19 AMSU 8.


Preprocessing
=============
M      AAPP/src/preproc/libatovpp/ppb2a.F
M      AAPP/src/preproc/libatovpp/ppa2h.F
M      AAPP/src/preproc/libatovpp/ppa2i.F
Make sure missing BTs are not included in the mapping.

M      AAPP/src/preproc/libatovpp/ppipc1d.F
M      AAPP/src/preproc/libatovpp/ppi1d.F
Store the EUMETSAT cloud and land fractions in ICloudflag


Navigation
==========
M      AAPP/src/navigation/libtbus/tb_dc.F
M      AAPP/src/navigation/libtbus/clkerr_dc.F
Add read checks.

M      AAPP/src/navigation/libtbus/tb_sdc.F
Ignore blank lines in Section 4 and add read checks.


Tools
=====
A      AAPP/src/tools/bin/reorder_1c.F
A      AAPP/src/tools/bin/reorder_1c.ksh
M      AAPP/src/tools/bin/Makefile
New tool to put scan lines in time order, remove duplicates and create new scan
line numbers. For use with data extracted from some archives e.g. ECMWF.

M      AAPP/src/tools/libaappbufr/aapp_get_1c.F
Bug fix, the iasi1c_GQisFlagQual was only partially set.


MAIA3
=====
M      AAPP/src/maia3/bin/MAIA3_RUN.ksh
use "ln -sf" for input file

M      AAPP/src/maia3/bin/maia3_env.ksh
Move definition of MMC, to ensure the value is always set before it is used.

M      AAPP/src/maia3/bin/avhrrin.F
Allow avh_h_dataname to be empty (e.g. if file is generated using convert_avh1b).



MetOp tools
===========
M      metop-tools/src/libeps_avhrrl1b_6.5/eps_avhrrl1b_6.5.c
M      metop-tools/src/libeps_metopl0/eps_metopl0.c
Allow for extra GIADR in UMARF files.

A      metop-tools/include/aapp_avhrrl1c.h
A      metop-tools/src/bin/aapp1d2pfs.c
A      metop-tools/src/bin/aapp1d2pfs.ksh
M      metop-tools/src/bin/Makefile
A      metop-tools/src/libaapp_avhrrl1c
A      metop-tools/src/libaapp_avhrrl1c/aapp_avhrrl1c.xml
A      metop-tools/src/libaapp_avhrrl1c/aapp_avhrrl1c.c
A      metop-tools/src/libaapp_avhrrl1c/Makefile
M      metop-tools/Makefile
New tool aapp1d2pfs to extract cloud mask from AVHRR 1c file and apply it to an
AVHRR 1b PFS file. This can be used as input for OPS-LRS.