#### # # ##### ##### # # # # # # # # # # # # # # # # # # # ## # # # ##### # # ## ## # # # #### # # ##### # RELEASE NOTE 1.1.00 OSCAT Wind Data Processor (OWDP) Version 1.1 06 February 2013 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 2013, EUMETSAT, All Rights Reserved. CHANGE RECORD Version Date Author/changed by Remarks --------------------------------------------------------------- 1.0.01 20-12-2011 Anton Verhoef First draft, for OWDP 1.0 beta release 1.1.00 06-02-2013 Anton Verhoef Version for OWDP 1.1 public release 1.1.01 28-02-2013 Anton Verhoef Comments of DRI incorporated INTRODUCTION The OSCAT Wind Data Processor (OWDP) is a software package written in Fortran 90 for handling data from the scatterometer instrument onboard Oceansat-2 (OSCAT). OWDP generates surface winds based on OSCAT backscatter 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 OWDP consists of wind vectors which represent surface winds within the ground swath of the scatterometer. Input of OWDP is Normalized Radar Cross Section (NRCS) data. The input files of OWDP are in HDF5 or BUFR format. It is designed to handle the OSCAT level 2a HDF5 data from the Indian Space Research Organisation (ISRO). Output is written in BUFR format using the SeaWinds BUFR template by default. Moreover, OWDP 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 OWDP, 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 OWDP. For details about the changes in this and previous releases, see the file owdp/doc/history_of_changes.txt. CONTENTS IN THIS PACKAGE The tar file contains everything necessary to install OWDP in a UNIX/Linux environment, except for some ECMWF software libraries that need to be downloaded separately (see below). Contents of the owdp directory: doc Documentation, including this document execs Link to owdp executable, shell script for running OWDP src Source code for OWDP 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/hdf5 HDF5 handling routines support/num Numerical definitions and number handling routines support/singletonfft FFT routines needed in minimization support/sort Sorting routines APPLICABLE DOCUMENTS In directory owdp/docs: - OWDP Release Note (OWDP_Release_Note.txt), this document. - OWDP User Manual and Reference Guide (OWDP_UM_and_RG.pdf, NWPSAF-KN-UD-006), 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/): - OWDP Test Report (OWDP_TR.pdf, NWPSAF-KN-TV-006), a document that contains all undertaken tests and their results. Delivered only internally for review purposes: - Beta user feedback (user_feedback_owdp.pdf). - NWP SAF Software Development Record (OWDP_SDR.doc). INSTALLING OWDP The system requirements for compiling and running OWDP are described in section 3.4 of the User Manual and Reference Guide. In short, OWDP 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 OWDP, the following steps must be taken: 1. Copy the OWDP package (file OWDP.tar.gz) to the directory from which OWDP will be applied, and unzip and untar it. This will create subdirectories owdp and genscat that contain all code needed, and a script called InstallOWDP for easy compilation. 2. Download the ECMWF BUFR library file bufr_000387.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. 3. Download the ECMWF GRIB API library file grib_api-1.9.18.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 ./InstallOWDP which is in the top directory and follow its directions. 5. OWDP is now ready for use, provided that the environment variables have the proper settings. OWDP can be invoked by the the script owdp/execs/owdp_run, which sets all necessary environment variables. 6. The owdp/tests directory contains some sample OSCAT 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.