*-----------------------------------------------*
           |       Atlas of Surface Marine Data 1994       |
           | UWM/COADS 0.5x0.5 Deg. Weekly Access Software |
           |           Last Revision: Nov 26, 1996         |
           *-----------------------------------------------*

 
                                 ^|^
                                 _|_
                          @  ___|___|__
                         _|_|__________|________/
                        \  o o o o o o o  /
                         \_______________/
                      ^^^^^^^^^^^^^^^^^^^^^^^^



This directory contains Fortran access code to read the objectively
analyzed 0.5x0.5 Degree Weekly Climatology fields produced
at the University of Wisconsin-Milwaukee (UWM) by Christine Young-Molling
in collaboration with Arlindo da Silva of the Data Assimilation office
at NASA Goddard Space Flight Center and Syd Levitus from the Ocean
Climate Lab of NOAA/National Oceanographic Data Center.  Inquiries
regarding the data set should be directed to the address below.


                       LIST OF FILES
                       -------------


makefile.uwm        Example UNIX makefile
readme.sof          This file
netcdf.inc	    Include file for netCDF
cld_wkc.cdl         Output from 'ncdump' for comparison for Part 1,
ac_wkc.cdl	        Part 2, and Part 3 of the 0.5 x 0.5 Degree
buoy_wkc.cdl            Weekly Data Set, respectively.
testwk.f            A sample FORTRAN program 
testcld.uwm         Output from the test program for comparison for
testac.uwm		Part 1, Part 2, and Part 3 of the 0.5 x 0.5
testbuoy.uwm		Degree Weekly Data Set, respectively.
nccwk_io.f          Access subroutines


                  INSTALLATION AND TESTS (UNIX)
                  -----------------------------


0) Make sure you have netCDF installed on your system.  If not,
   you can install it using the files in the directory 'netcdf'
   or you may obtain this Public Domain software from 

   % ftp unidata.ucar.edu
   % Name: anonymous
   % Password: (your e-mail address)
   ftp> cd pub
   ftp> bin
   ftp> get netcdf.tar.Z
   ftp> quit

   and follow the installation instructions.  Binaries for some
   machines can be obtained via anonymous ftp from
   niteroi.gsfc.nasa.gov in 'pub/uwm_coads/1x1/software/netcdf_bin'.
   There you will find pre-compiled netCDF libraries for the
   following machines:

   File name             Hardware         OS
   ---------            ----------     ---------
   aix.tar.Z            IBM RISC       AIX
   dec_osf.tar.Z        DEC ALPHA      OSF
   dec_ultrix.tar.Z     DEC            Ultrix            
   hpux.tar.Z           HP 9000        HPUX
   irix4.tar.Z          SGI            IRIX 4.x
   irix5.tar.Z          SGI            IRIX 5.x
   sunos4.tar.Z         Sun Sparc      SunOS 4.x          
   unicos.tar.Z         Cray C90       Unicos
   
   Installation instructions can be found in the file README in that
   directory.

1) To make sure your installation of netCDF is compatible with ours,
   We suggest that you run the utility 'ncdump' on a data
   file and compare the results.  We have supplied a test "cdl" file
   for one data file from each part of the data set (cld_wkc.cdl for
   Part 1, ac_wkc.cdl for Part 2, and buoy_wkc.cdl for Part 3).  For
   example:

   % ncdump -h cld_wkc.nc > cld_wkc.my
   % diff cld_wkc.my cld_wkc.cdl

   If the two files are identical then 'diff' will be quiet.
   In this case go on.  Otherwise, you will need to investigate
   the cause of the problem.  The command 'ncdump -h' can be used to
   show the header information of any of the data files.  Read the
   man page for ncdump or type 'ncdump -H' to see other options.

2) You will need to edit our file 'netcdf.inc' to specify the
   actual location of the netCDF include file 'netcdf.inc'. This file
   contains your machine dependent parameters. This file usually 
   resides in '/usr/local/include' or '/usr/local/ldm/include'.  You
   need to do this to proceed.

3) Edit the makefile.uwm to properly identify
   a) your FORTRAN compiler and desired options
   b) the location of your netCDF libraries (libnetcdf.a)

   and then use the makefile to create an executable program, from
   testwk.f, called testwk.x:

   % make -f makefile.uwm testwk.x

4) Run the test program and enter the FULL NAME of the appropriate
   weekly data file ( e.g. '/datadir/uwmcoads/data/cld_wkc.nc' if you
   are testing data from Part 1.  Use ac_wkc.nc for Part 2 or
   buoy_wkc.nc for Part 3):

   % testwk.x
	<enter name of file>

The output for comparison will be written in the file 'fort.10'.  Then
compare 'fort.10' with the appropriate test output file (testcld.uwm
for cld_wkc.nc, testac.uwm for ac_wkc.nc, or testbuoy.uwm for
buoy_wkc.nc):

   % diff fort.10 testcld.uwm

   The two files (fort.10 and testcld.uwm) should be identical, although
some computers may put different size tabs or spacing in some of the
text lines.

To read UWM/COADS 0.5x0.5 weekly climatology netCDF data files in your
own programs you will need only the files:

nccwk_io.f
netcdf.inc

Read the comments in 'nccwk_io.f', and use 'testwk.f' as an example.
If you have questions about netCDF, direct them to
'netcdfgroup@unidata.ucar.edu'.  Send questions about the data sets
and 'nccwk_io.f' to 'uwmcoads@niteroi.gsfc.nasa.gov'.  The latest
software for the half degree data set is available at the anonymous
ftp site niteroi.gsfc.nasa.gov in the directory
'pub/uwm_coads/0.5x0.5/software/'.



Good Luck!