## # # ##### ##### # # # # # # # # # # # # # # # # ###### # ## # # # ##### # # ## ## # # # # # # # ##### # RELEASE NOTE 2.3.00 ASCAT Wind Data Processor (AWDP) Version 2.3 03 July 2014 This documentation was developed within the context of the EUMETSAT Satellite Application Facility on Numerical Weather Prediction (NWP SAF), under the Cooperation Agreement dated 29 June, 2011, between EUMETSAT and the Met Office, UK, by one or more partners within the NWP SAF. The partners in the NWP SAF are the Met Office, ECMWF, KNMI and Meteo France. Copyright 2014, EUMETSAT, All Rights Reserved. CHANGE RECORD Version Date Author/changed by Remarks --------------------------------------------------------------- 1.0.14 12-11-2008 Anton Verhoef First draft, for AWDP 1.0 DRI 1.0.16 18-12-2008 Anton Verhoef Modified according to DRI comments 1.1.00 12-10-2010 Anton Verhoef Modified for AWDP version 1.1 Note that version 1.1 is identical to internal version 1.0.19 2.0.00 17-06-2010 Anton Verhoef Modified for AWDP version 2.0 2.0.01 24-11-2010 Anton Verhoef Modified according to DRI comments 2.1.00 28-07-2011 Anton Verhoef Modified for AWDP version 2.1 2.2.00 03-07-2013 Anton Verhoef Modified for AWDP version 2.2 2.3.00 05-02-2014 Anton Verhoef Modified for AWDP version 2.3 INTRODUCTION The ASCAT Wind Data Processor (AWDP) is a software package written in Fortran 90 for handling data from the Advanced Scatterometer (ASCAT) and European Remote Sensing satellite (ERS) scatterometer instruments. AWDP generates surface winds based on ASCAT and ERS data. It allows performing the ambiguity removal with the Two-dimensional Variational Ambiguity Removal (2DVAR) method and it supports the Multiple Solution Scheme (MSS). The output of AWDP consists of wind vectors which represent surface winds within the ground swath of the scatterometer. Input of AWDP is Normalized Radar Cross Section (NRCS) data. The input files of AWDP are in BUFR or Product Format Specification (PFS, native Metop) format. BUFR input may be provided using the BUFR templates for ERS or ASCAT; output is always written using the ASCAT BUFR template. Moreover, AWDP needs Numerical Weather Prediction (NWP) model winds as a first guess for the Ambiguity Removal step. These data need to be provided in GRIB. If you have any questions concerning AWDP, please contact the NWP SAF help desk on http://www.nwpsaf.org/. HISTORY OF SOFTWARE CHANGES This Release Note applies to the public release of AWDP. For details about the changes in this and previous releases, see the file awdp/doc/history_of_changes.txt. CONTENTS IN THIS PACKAGE The tar file contains everything necessary to install AWDP in a UNIX/Linux environment, except for some ECMWF software libraries that need to be downloaded separately (see below). Contents of the awdp directory: doc Documentation, including this document execs Link to awdp executable, shell script for running AWDP src Source code for AWDP program and supporting routines test Example BUFR and GRIB input files for testing purposes. Contents of the genscat directory: ambrem Ambiguity removal routines ambrem/twodvar KNMI 2DVAR ambiguity removal routines icemodel Ice screening routines inversion Inversion and quality control routines main Dummy subdirectory to facilitate the make system support General purpose routines sorted in subdirectories support/BFGS Minimization routines needed in 2DVAR support/bufr BUFR tables (in subdirectory) and file handling routines support/Compiler_Features Compiler specific routines, mainly command line handling support/convert Conversion between wind speed/direction and u and v support/datetime Date and time conversion routines support/ErrorHandler Error handling routines support/file File handling routines support/grib GRIB file handling routines support/num Numerical definitions and number handling routines support/pfs PFS file handling routines support/singletonfft FFT routines needed in minimization support/sort Sorting routines APPLICABLE DOCUMENTS In directory awdp/docs: - AWDP Release Note (AWDP_Release_Note.txt), this document. - AWDP User Manual and Reference Guide 2.3 (AWDP_UM_and_RG.pdf, NWPSAF-KN-UD-005), a document that contains all relevant information for the user. It includes the Scientific Description, Software Description, Data Format Description, Product Specification, Top Level Design, and Installation Guide. - History of Changes (history_of_changes.txt), a list of all relevant changes and bug fixes in the software packages in all internal and external releases. Delivered separately / to be obtained from the NWP SAF web site (http://www.nwpsaf.org/): - AWDP Test Report 2.3 (AWDP_TR_v2_2.pdf, NWPSAF-KN-TV-005), a document that contains all undertaken tests and their results. - AWDP 1.0 Validation (AWDP_1.0_validation_for_review.pdf, NWPSAF-KN-TR-020), a document that provides validation information about the ASCAT wind products that are generated by AWDP. Delivered only internally for review purposes: - Beta user feedback (user_feedback_awdp.pdf). - NWP SAF Software Development Record (AWDP_SDR_v2_2.doc). INSTALLING AWDP The system requirements for compiling and running AWDP are described in section 3.4 of the User Manual and Reference Guide. In short, AWDP should run on most Unix/Linux based platforms with e.g. the Portland, g95, gfortran, Sun, Intel or SGI compilers. Detailed instructions for installation can also be found in the User Manual and Reference Guide, section 2.3. A shortened version is given here. To install AWDP, the following steps must be taken: 1. Copy the AWDP package (file AWDP.tar.gz) to the directory from which AWDP will be applied, and unzip and untar it. This will create subdirectories awdp and genscat that contain all code needed, and a script called InstallAWDP for easy compilation. 2. Download the ECMWF BUFR library file bufr_000400.tar.gz (or another version not earlier than 000240 and not later than 000387) from http://www.ecmwf.int/products/data/software/bufr.html and copy it to directory genscat/support/bufr. Note that library versions 000388 and 000389 are not supported. 3. Download the ECMWF GRIB API library file grib_api-1.11.0.tar.gz (or another version not earlier than 1.9.0) from http://www.ecmwf.int/products/data/software/grib_api.html and copy it to directory genscat/support/grib. 4. Run the script ./InstallAWDP which is in the top directory and follow its directions. 5. AWDP is now ready for use, provided that the environment variables have the proper settings. AWDP can be invoked by the the script awdp/execs/awdp_run, which sets all necessary environment variables. 6. The awdp/tests directory contains some sample ASCAT, ERS and NWP files that can be used to test the software. See the readme.txt in this directory for more details. KNOWN PROBLEMS During installation, the g95 and gfortran compilers issue warning messages. These can be safely neglected. Some users have reported problems at runtime with older versions of the gfortran compiler. When you have a version older than 4.6.3, it may be advisable to upgrade.