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

This is the main directory of the little_r program in the MM5 modeling 
system Version 3. Everything a user needs to run the little_r program 
is contained in this directory.

For questions, please send emails to mesouser@ucar.edu

For detailed documentation about little_r program, please see Doc/.

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

What is in V3 little_r?

V3 little_r has similar functions in V2 little_r. It is designed for
users who don't have access to NCAR's ADP archive.

More information is available under LITTLE_R/Doc directory.

For documentation on LITTLE_R, please see our online Tutorial Notes:

http://www2.mmm.ucar.edu/mm5/doc.html

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

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

LITTLE_R is a Fortran 90 program, and requires Fortran 90 compiler.

LITTLE_R is supported for Cray, Alpha, HP, IBM, SGI, SUN, and Fujitsu with
their native compilers, and PC running Linux using Portland Group Fortran
90 compiler. If your machine isn't one of the ones supported or the
compiler isn't the native one from the vendor, you need to edit the Makefile.

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

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

To compile little_r:

- Type 'make' in the LITTLE_R directory to complie;

- When make is successful, executable little_r will be created in this
  directory.

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

To run little_r:

Edit namelist.input, and type ./little_r to execute the program.

Required input file for little_r include output from REGRID: REGRID_DOMAIN1,
and observation files. The directory and name of these files are
set in namelist.input.

The output file from little_r is LITTLE_R_DOMAIN1.

Starting with V3.5, if one sets f4d = .TRUE., and provides the program with 
observed surface data files, one generate surface FDDA files like in RAWINS. 
The surface analysis FDDA file is the same as that produced from RAWINS:

SFCFDDA_DOMAIN1

If you need to run little_r for multiple domains, edit namelist.input 
to set appropriate input files from REGRID, and little_r will then produce
corresponding outputs, e.g., REGRID_DOMAIN2 --> LITTLE_R_DOMAIN2, etc.

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

Files/directories in this directory:

Doc:       directory containing more documentation on little_r
CHANGES:   description of changes made in each release
Makefile:  top-level makefile
README:    general information about how to run little_r
namelist.input: namelist file requiring user modification
src:       directory of little_r source code.
util:      directory that holds sample file to create observation data
           input file for little_r