Quick start installation of the WRFSI for typical users.

1.  Install and compile the WRF model first.

2.  After you have built the WRF model, cd into the top level directory
    created when you untarred the WRF distribution file and untar the 
    WRFSI.TAR.gz file in that location, so that the WRFSI top level directory
    is parallel with the "main" subdirectory of the WRF model.  

3.  Determine where the netcdf package is installed on your system and 
    set the NETCDF environment variable.  Often, it is '/usr/local/netcdf', but
    may be different on some systems.  The NETCDF directory you set must contain
    the "include", "bin", and "lib" subdirectories for the netCDF package.  
    In csh/tsch:

       setenv NETCDF /your/path/to/netcdf

    or, in ksh/sh:

       export NETCDF=/your/path/to/netcdf  

4.  If you are running the MPI version of WRF, then set the MPICH environment
    variable for where the MPI "bin", "lib", and "include" subdirectories
    are located.  For example, if your MPI is installed in "/usr/local/mpich":

      setenv MPICH /usr/local/mpich   (for csh/tcsh)
  
      export MPICH=/usr/local/mpich   (for ksh/sh)

5.  If you wish to use the built in support for the OpenPBS job queuing system,
    set an environment variable called "PBS" that specifies where PBS is 
    installed.  For example, if PBS is in "/usr/local/pbs":

      setenv PBS /usr/local/pbs  

        - or -
 
      export PBS=/usr/local/pbs

6.  Ensure "perl" is installed and in your default path. 

7.  Decide where you want "global" data to reside.  "Global" or "external" 
    data sets are those which apply to ANY domain you create.  For example,
    the global topography, land usage, albedo, etc. data tiles used when
    you build your domain.  Also, if you define multiple domains, but wish
    to use the same global model as lateral boundaries for all of them 
    (e.g. the AVN), these data would reside here.  We refer to this in
    the scripts and documentation as the "EXT_DATAROOT" (for "external"
    data).  You should reserve at least 10GB for this area.  If you don't
    specify where you want this directory to be using the --ext_dataroot=
    option during installation, or by setting the EXT_DATAROOT environment
    variable, the installation will assume you are using the "extdata" 
    subdirectory created when you untarred the file.

8.  If you already have the global geographical data sets (tiled
    30 second topo, land use, soil types, albedo, etc.) on your
    system from a previous WRFSI installation, set an environment
    variable called GEOG_DATAROOT pointing to the top level directory
    that contains the various subdirectories ("topo_30s, landuse_30s, etc.)
    or use the --geog_dataroot switch on the command line.  This will
    cause your default namelist templates to have the correct path
    set for these data sets, and the install script will also check to 
    see if you have the required data sets.  Otherwise, you can
    ignore this switch and the system will assume that you will put
    these data in EXT_DATAROOT/GEOG (see above discussion on
    EXT_DATAROOT).  

9.  If you are a previous user of WRFSI and have been using "template"
    files in conjunction with the window_domain_rt.pl script, then
    you can also set the "TEMPLATES" environment variable to point
    to the top-level directory containing your various template
    subdirectories.  You can also set this using the --templates
    switch.  If you don't set this, the template directory will
    be "INSTALLROOT/templates.

10. Decide where you want your data sets for all of your created
    domain to reside.  We will call this "DATAROOT".  If you
    are a prior SI user and understand what a MOAD_DATAROOT is,
    then you will understand when we state that each MOAD_DATAROOT
    will be a subdirectory of "DATAROOT".  If you don't set this
    then the default location is INSTALLROOT/domains.

11.  Go into the top-level WRFSI directory and issue:

    perl install_wrfsi.pl --help 

    This will show you all of the options available.  If you set the NETCDF
    enviroment variable and nothing else, you can do this:

     perl install_wrfsi.pl

    This will assume the INSTALLROOT is the current directory, and that your
    default data and extdata directories are also in your working directory.

12. This should build the code.  
