##############################################################################
#                                                                            #
#                 ATOVS and AVHRR Preprocessing Package (AAPP)               #
#                        Version 7.1 Release Notes                           #
#                              29 Feb 2012                                   #
#                                                                            #
##############################################################################

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

  RELEASE_NOTE_AAPP_7.1.txt         5797 This release note
  AAPP_7.1.tgz                  39068325 Source code and data files
  AAPP_MAIA3_data.tgz          135316049 Data for MAIA3 (unchanged from AAPP
                                         v6.12)
  INSTGUID.tgz                     32879 Installation guide (html documents)
  DOCS.tgz                       4574543 Scientific and software documents (pdf)

  Test cases:
    ATMS_CrIS.tgz              105470260 ATMS and CrIS ingest and pre-processing
    FY3A.tgz                    15714061 FY3A ingest and pre-processing
    MAIA_noaa19.tgz             72088243 MAIA test cases
    metopa_20100128.tgz        241245052 MetOp direct readout test case
    noaa16_test.tgz             45490480 NOAA-16 case from 2001 (same case as
                                         AAPP v6, but reference results updated)
    noaa18_test.tgz             67449705 NOAA-18 case from 2005 (same case as
                                         AAPP v6, but reference results updated)

The IASI OPS-LRS (For IASI level 0 to level 1c processing) is an optional
addition to AAPP v7 and is delivered on request. It has its own release note.


2. License
----------
To use this software, users need to need to have registered for AAPP v7 with the
NWP SAF (www.nwpsaf.org), and to have agreed to the terms of the license
agreement.


3. Delivery mechanism
---------------------
The usual delivery mechanism for AAPP v7 will be by FTP. Users who are unable to
download the package by FTP should contact the NWP SAF Helpdesk. The files are
held in directory "7.1" on the AAPP v7 ftp site, except for the test cases
which are held in the "test_cases" directory.


4. System requirements
----------------------
Supported platforms include: AIX, Solaris, Linux PC. Not all parts of AAPP
are supported on all platforms: see the Installation Guide for more details.

32-bit or 64-bit systems may be used.

To build AAPP v7 requires a Fortran 90 or FORTRAN 77 compiler and a C compiler.

Standard Unix utilities (including make, ar, tar, perl5) are used.
 

5. Unpacking the files
----------------------
Apart from the release note, all other files are packaged as gzipped tar files.
To unpack, bring up a Unix terminal window, copy the tgz file to a suitable
location on your file system and enter the command:

  tar -xzf xxx.tgz            where xxx is the name of the component
  
or if your system does not support the "-z" option in tar,

  gunzip -c xxx.tgz | tar -xf -
  
When you unpack each component a sub-directory is automatically created, e.g.
DOCS/ for the main documents, INSTGUID/ for the Installation Guide.


6. Documentation
----------------
The following documents are included in DOCS.tgz:

  NWPSAF-MF-UD-001_Science.pdf         AAPP Scientific description 
  NWPSAF-MF-UD-002_Software.pdf        AAPP Software description
  NWPSAF-MF-UD-003_Formats.pdf         AAPP Data Formats description
  NWPSAF-MO-UD-004_Overview.pdf        AAPP Overview
  NWPSAF-MF-UD-005_Navigation.pdf      Annex of scientific description - 
                                         AAPP navigation
  NWPSAF-MO-UD-027_ATMS_CrIS.pdf       Annex of scientific description - 
                                         Pre-processing of ATMS and CrIS
  NWPSAF-MO-DS-014_Prod_Spec_AAPPv7.pdf       Product specification
  NWPSAF-MO-DS-015_TopLevelDesign_AAPPv7.pdf  Top level design
  NWPSAF-MO-TV-016_TestPlan_AAPPv7.pdf        Test plan
  
  
They may be viewed using Adobe Acrobat Reader.

The Installation Guide, INSTGUID.tgz, consists of a set of HTML files that are
linked to each other: 

  COVER.HTM, TOC.HTM, CH1.HTM, CH2.HTM, CH3.HTM, CH4.HTM

The guide should be readable by means of any web-browser. Start at the cover
page COVER.HTM from where you get to the Table of Contents which allows you to
access any section directly.


7. Version control information
------------------------------
The source package (AAPP_7_1.tgz) corresponds to Subversion Revision 310 in the
AAPP repository at the Met Office. 

Documents are issued at the following versions:
  NWPSAF-MF-UD-001   Version 7.0  AAPP Scientific description
  NWPSAF-MF-UD-002   Version 7.0  AAPP Software description 
  NWPSAF-MF-UD-003   Version 7.1  AAPP Data Formats description
  NWPSAF-MO-UD-004   Version 7.0  AAPP Overview
  NWPSAF-MF-UD-005   Version 1.3  AAPP navigation
  NWPSAF-MO-UD-027   Version 1.0  Pre-processing of ATMS and CrIS
  NWPSAF-MO-DS-014   Version 1.0  AAPP version 7 product specification
  NWPSAF-MO-DS-015   Version 1.0  AAPP version 7 top level design
  NWPSAF-MO-TV-016   Version 1.0  AAPP version 7 test plan
  NWPSAF-MO-UD-005   Version 7.1  AAPP Installation Guide
  
8. Test cases
-------------
To run a test case, please see the instructions in the installation Guide
(chapter 4) and in the README.txt files included within each test case.


9. AAPP Web site
----------------
For further information on AAPP, please visit the NWP SAF web site at
  http://www.nwpsaf.org

For bug reports, suggestions for improvement, etc., please use the NWP SAF 
feedback form, linked from the above web site.