Filename:        cam/tools/README
Original Author: Erik Kluzek
Date:            Apr/30/1998
Description:     Description of the cam/tools module.
                 (Various off-line tools that operate on)
		   (CAM input and output datasets)
Version-Control: 
 
CVS: $Id$
CVS: $Source$
CVS: $Name$
 
############################################################################

I.      Description of cam/tools.

cam/tools contains various off-line programs that operate on CAM input
and output datasets.  Each of these tools requires netCDF3.x.x
(http://www.unidata.ucar.edu/) or beyond.  It is assumed that netCDF
has been installed under/usr/local.  If installed elsewhere, the
environment variables $INC_NETCDF and $LIB_NETCDF must be set to point
to the location of the netCDF include files and library, respectively.

############################################################################

II.     Description of tools contained in this module.

1.) interpic:		Horizontally and/or vertically interpolates an 
			initial condition dataset to a user-specified 
			resolution.

2.) definesurf:	Defines CAM surface fields SGH, PHIS, and ORO on 
			an initial condition dataset.  Input comes from a 
			high resolution topography dataset.

3.) mkrgrid:		Tool to translate datafiles from full to 
			reduced grid or vica versa. Reduced grid files
			can be converted to full-grid for plotting
			and full grid files can be converted to
			reduced for a reduced grid simulation.

4.) mkrgridsst:	Tool to translate SST datafiles from full to 
			reduced grid.

5.) cprnc:		Tool to compare two CAM netCDF history files.
			Figures out RMS and min/max differences for
			each field. Useful for plotting error growth
			statistics.
			


############################################################################
