_____ _____ _____ _____ _____ _____ _____ _____ _____ _____ |_____|_____|_____|_____|_____|_____|_____|_____|_____|_____| ____ __ ___ _ / ___| ___ __ \ \ / (_)_ __ __| |___ \___ \ / _ \/ _` \ \ /\ / /| | '_ \ / _` / __| ___) | __/ (_| |\ V V / | | | | | (_| \__ \ |____/ \___|\__,_| \_/\_/ |_|_| |_|\__,_|___/ ____ _ | _ \ __ _| |_ __ _ | | | |/ _` | __/ _` | | |_| | (_| | || (_| | |____/ \__,_|\__\__,_| ____ | _ \ _ __ ___ ___ ___ ___ ___ ___ _ __ | |_) | '__/ _ \ / __/ _ \/ __/ __|/ _ \| '__| | __/| | | (_) | (_| __/\__ \__ \ (_) | | |_| |_| \___/ \___\___||___/___/\___/|_| _____ _____ _____ _____ _____ _____ _____ _____ _____ _____ |_____|_____|_____|_____|_____|_____|_____|_____|_____|_____| RELEASE NOTE 2.2 SeaWinds Data Processor (SDP) Version 2.2 September 9, 2014 Document NWPSAF-KN-UD-003 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 Météo France. Copyright 2014, EUMETSAT, All Rights Reserved. INTRODUCTION The SeaWinds Data Processor (SDP) is a software package written in Fortran 90 for handling data from the SeaWinds scatterometer carried by QuikSCAT. SDP generates surface winds based on SeaWinds 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 SDP consists of wind vectors which represent surface winds within the ground swath of the scatterometer. Input of SDP is Normalized Radar Cross Section (NRCS) data. The input files of SDP are in BUFR format. BUFR input must be provided using the NOAA BUFR templates for SeaWinds; output may be written using the NOAA or KNMI BUFR template. The Numerical Weather Prediction (NWP) model winds needed by SDP as a first guess for the Ambiguity Removal are already contained in the NOAA BUFR input files. If you have any questions concerning SDP, please contact the NWP SAF help desk on http://nwpsaf.eu/. HISTORY OF SOFTWARE CHANGES These Release Notes apply to SDP 2.2. For details about the changes in earlier versions, see the file SDP/doc/history_of_changes.txt. CONTENTS IN THIS PACKAGE The tar file contains everything necessary to install SDP in a UNIX/Linux environment, except for the ECMWF BUFR software library that needs to be downloaded separately (see below). Contents of the SDP directory: data Tables with Geophisical Model Functions (GMF) needed to retrieve wind vectors docs Documentation, including this document execs Link to sdp executable, shell scripts for running SDP python Python scripts for running SDP sdp Source code for SDP program and supporting routines sws Source code for SeaWinds specific supporting routines tests Example BUFR input and output files for testing purposes. Contents of the genscat directory: ambrem Ambiguity removal routines ambrem/twodvar KNMI 2DVAR ambiguity removal routines icemodel KNMI ice model routines inversion Inversion and quality control routines 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/num Numerical definitions and number handling routines support/singletonfft FFT routines needed in minimization support/sort Sorting routines APPLICABLE DOCUMENTS In the top directory: - SDP Release Notes (SDP_Release_Notes.txt), this document. In directory SDP/docs: - SDP User Manual and Reference Guide 2.2 (SDP_UM_and_RG.pdf, NWPSAF-KN-UD-002), 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. - SDP_Test_Report 2.2 (SDP_Test_Report.pdf, NWPSAF-TV-002), a document that contains all tests performed on SDP and their results. - 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. From the NWP SAF web site (http://nwpsaf.eu): - SDP 2.0 Validation (NWPSAF-KN-TR-006), a document describing the validation of some new features of SDP 2.0 like outer swath processing. - Two dimensional variational ambiguity removal (NWPSAF-KN-TR-004), a report describing 2DVAR in detail. From KNMI's scatterometer web pages: - www.knmi.nl/scatterometer/nscat_gmf Delivered only internally for review purposes: - NWP SAF Software Development Record (SDP_2.2_Software_Development_Record.pdf). INSTALLING SDP The system requirements for compiling and running SDP are described in section 3.4 of the User Manual and Reference Guide. In short, SDP 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 SDP, the following steps must be taken: 1. Copy the SDP package (file SDP_.tar.gz) to the directory from which SDP will be applied, and unzip and untar it. This will create subdirectories SDP and genscat that contain all code needed, the Release Notes, and a script named InstallSDP for easy compilation. 2. Download the ECMWF BUFR library file bufrdc_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. 4. Run the script InstallSDP which is in the top directory and follow its directions. 5. SDP is now ready for use, provided that the environment variables have the proper settings. SDP can be invoked by one of the scripts in SDP/execs. These scripts set all necessary environment variables. 6. The SDP/tests directory contains a sample NOAA BUFR input file, three scripts for running SDP on this input file, and the resulting BUFR output files. These can be used to test the software. See section 2.6 of the User Manual and Reference Guide for more details. KNOWN PROBLEMS During installation, the g95 and gfortran compilers issue warning messages. These can be safely neglected.