
VERSION 3 OF RAWINS PROGRAM (release 3-7)
(Updated December 23, 2004)

This is the main directory of RAWINS program in MM5 modeling system 
Version 3. Everything a user needs to run the RAWINS program on Cray,
a unix workstation, and a PC running Linux is contained in this directory, 
except for NCAR Graphics.

Program RAWINS does not require NCAR Graphics to run. With NCAR
Graphics, a user can create sounding plots of incoming observations.
If autobogus option is selected, plots can be generated to help a
user to determine which observations may be used.

NCAR Graphics is a licensed software, but part of it has become free.
RAWINS program only requires this part of the NCAR Graphics to produce
plots. For information on NCAR Graphics, please visit

    http://ngwww.ucar.edu/info/pricing.html

All fortran source code is located in directory src/. 

For bug fixes, please read file CHANGES.

Questions? Send email to mesouser@ucar.edu

--------------------------------------------------------------

What is in V3 RAWINS?

The version of RAWINS is a one-source program for Cray, unix workstations, 
and PC running Linux. The job decks have a similar structure as the ones 
in V2 system. 

V3 RAWINS has been tested on Cray, SGI, DEC_Alpha, SUN, IBM and PC 
running Linux.

V3 RAWINS program uses V3 data format, which is different from
that in V2. For details on V3 data format, please see

http://www.mmm.ucar.edu/mm5/mm5v3.html

--------------------------------------------------------------

***************************************************************
Also see the online self-tutorial at
http://www.mmm.ucar.edu/mm5/mm5v3/tutorial/teachyourself.html
***************************************************************

How to Compile and Run RAWINS Program:

There are two ways to compile and run RAWINS program. Since RAWINS is a
Fortran 77 program, one must first set the parameter statements. You 
can do so either by editing src/paramdim.incl file, or edit the deck.

1. Compile via job deck: To get a rawins job deck, type:

   make rawins.deck

   Note: if you don't have NCAR Graphics, set NCARGRAPHICS to NONCARG
         in Makefile. NCAR Graphics is not necessary to run RAWINS, but 
         it can make plots if you choose IPLOT option in the deck, or 
         autobogus option.
         If you don't have netCDF, set NETCDFOPT to NONETCDF in Makefile.

   Edit rawins.deck to set parameter dimensions. Note that the horizontal
   dimensions must be exact. If you choose IEXP (expanded domain option
   in TERRAIN, RAWINS will process over the expanded domain. Check the output 
   from regridder to find out what the exact domain dimensions are for RAWINS.

   Also set script variables, and other namelist optoins/values.
   Note you can specify input file names in the job script.

   Type ./rawins.deck to compile and run.

2. (Recommended for experienced users only.)
   Edit paramdim.incl file in src/ directory to set domain dimensions. Go back
   to top directory and type 'make' to compile RAWINS. If the compilation is
   successful, rawins.exe will be created in src/ directory. 

   Type 'make rawins.deck' to create job script for your particular machine.

   Edit rawins.deck for script options, data location/file names, and namelist 
   options/values. 

   NOTE THAT THERE ARE ALSO PARAMETER STATEMENTS INSIDE THE DECK, TO AVOID 
   REMAKE OF RAWINS's EXECUTABLE, ONE MUST HAVE THE SAME DIMENSIONS IN THE 
   DECK AS IN THE paramdim.incl FILE.


Input Files for RAWINS:

From REGRID/regriddre:

   REGRID_DOMAIN1 (,2,...)

   Remember typically you only need to run RAWINS for domain 1 only.

From NCAR archive (standard RAWINS works only with ADP data from NCAR archive):

   Upper-air and surface observation data.

   These data can be found via data catalog from ~mesouser/catalog on Cray or 
   mesouser/catalog on anonymous ftp site. Obtain the data on Cray (you must 
   have a NCAR Cray account) with

   msread -fBI upperair_data /DSS/XXXXXX 
   msread -fBI sfc_data_3h   /DSS/XXXXXX
   msread -fBI sfc_data_6h   /DSS/XXXXXX

   where XXXXXX are volume names found in the catalog.

   rcp data back to local workstation.

   Or you can use fetch.job from Templates directory: edit the dates and
   area of interest (make it big). Submit the job to NCAR's Cray, and it will
   bring back files:

   UPA.1, 2, ...  radiosonde data (RAOBS_X in rawins.deck)
   A.1, 2, ...    6 hourly surface data (SFC6HR_X in rawins.deck)
   B.1, 2, ...    3 hourly surface data (SFC3HR_X in rawins.deck)


Output from RAWINS:

The output files from rawins job are

   RAWINS_DOMAIN1   - pressure level analyses to be used as input to INTERPF;
   SFCFDDA_DOMAIN1  - present if you set F4D = T: 3 hourly surface analyses 
                      to be used in MM5 with surface FDDA option directly;
   UPR4DOBS_DOMAIN1 - processed soundings; 
   SFC4DOBS_DOMAIN1 - processed surface reports;
   RAWOBS_DOMAIN1   - data as read in by RAWINS
   

Other notes:

1. To run RAWINS jobs on NCAR's Cray, copy rawins.deck.cray from 
   ~mesouser/MM5V3 directory, edit it and submit the deck in batch job queue
   using command 'qsub rawins.deck.cray'.

2. To obtain a single listing of the source code, type

   make code
   mv src/rawins.f rawins.listing ; cat src/*.f >> rawins.listing

---------------------------------------------------------

Files/directories in this directory:

CHANGES:   will contain changes made to this tar file
README:    basic information on how to run terrain program
Makefile:  top-level makefile
Templates: directory where templates of terrain.deck for various platform resides
x.tbl:     requried for NCAR Graphics to make plot file (TER.PLT)
src:       directory that holds all source code for terrain.
