README: Offline Noah-MP version 1.1 (consistent with WRF release 3.4.1)

Suggestions, comments, and corrections are welcome (mail to
kmanning@ucar.edu).


Source code:

    The main driver code is "driver.F".The Noah-MP LSM code is in file
    "module_sf_noahmplsm.F"; the main interface to this code is the
    call to subroutine NOAHMP_SFLX in the driver.  Other source-code files
    handle utility codes and details of the I/O procedures, and are
    not really intended for public consumption.  But feel free to hack
    away at those codes if you've got some ideas.

Note on NetCDF libraries:

    This code requires that the NetCDF libraries are installed on
    your machine.  In general, the code provided here should be
    compiled with the same compiler used to create the NetCDF
    libraries.  

Note on the graphics code:

    This distribution includes a plotting program, written with the
    NCAR-Graphics low-level utilities, for creating simple plots of the
    1d driver output.  This is located in subdirectory "graphics".
    This graphics code requires that the NCAR-Graphics libraries are
    installed on your machine.

    The graphics code is set up to compare two NetCDF output files to
    the observations found in the file "bondville.val".  It is
    pretty bare-bones stuff, and probably does not do what you want it
    to.  Don't expect much of it.  Right now, you are basically on
    your own for any more sophisticated graphical display of model
    output.

To compile:

    Edit the user_build_options file to set up compiler, compiler
    options, libraries, etc.  Adjust compiler options library
    paths, and libraries as necessary from the default settings
    provided in the default user_build_options file.

    Invoke "make" to compile.  This should create executable file
    "driver.exe".  Note that the Makefile included here is set up
    for the GNU make utility.  If "make" does not work on your
    system, try "gmake".  To compile the graphics code, change to 
    the "graphihcs" directory and invoke "make".

To run:

    execute:
      "driver.exe bondville.dat"

Input file:

    The forcing data and initial data are combined in a single file,
    in this case called "bondville.dat".  A namelist section in 
    that file describes site parameters and initial conditions. The
    namelist is followed by records of forcing fields.

Output files:

    Output will go to files "OUTPUT.????.nc", where "????" refers to
    the iteration number of an iteratively-cycled period.  At the
    driver level, the code to add or remove variables in the output
    files is easily adaptable.  See (in the driver code) the calls to
    subroutines output_levels and output_var.

To create some simple graphical output:

    To try the graphics code, execute:
       "graphics.exe -namelist graphics.namelist OUTPUT.nc OUTPUT.nc".
    The program creates an NCAR-Graphics gmeta file called "compare.cgm"
    Some tuning of the graphics is possible via options in the 
    "graphics.namelist" file.

    To see a few simple options to the graphics program, execute
    "graphics.exe -help"