*-----------------------------------------------* | Atlas of Surface Marine Data 1994 | | UWM/COADS Access Software | | Last Revision: Mar 08, 1995 | *-----------------------------------------------* ^|^ _|_ @ ___|___|__ _|_|__________|________/ \ o o o o o o o / \_______________/ ^^^^^^^^^^^^^^^^^^^^^^^^ This directory contains Fortran access code to read the objectively analyzed COADS fields (also the number of observation fields) produced at the University of Wisconsin-Milwaukee (UWM) by Arlindo M. da Silva and Christine C. Young in collaboration with Syd Levitus from the Ocean Climate Lab of NOAA/National Oceanographic Data Center. Since then both AMdS and CCY have left UWM, and 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 salinity.cdl Output from 'ncdump' for comparison salinity.nc Example NetCDF file (without anomalies!) test.f A sample FORTRAN program test.uwm Output from the test program for comparison uwmcdf.f Access subroutines uwmcdf.h Include file for 'uwmcdf.f' 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 our sample data file and compare the results: % ncdump -h salinity.nc > salinity.my % diff salinity.my salinity.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 for your compiler specific flags, and then simply enter % make -f makefile.uwm test.x 4) Run the test program: % test.x > test.my % diff test.my test.uwm The two files (test.my and test.uwm) should be identical. Note: Don't worry about NetCDF complaining that variable "anom" is not present; 'salinity.nc' is a simplified sample file which has no anomalies. To read UWM/COADS arrays in your own programs you will need only the files: uwmcdf.f uwmcdf.h netcdf.inc Read the comments in 'uwmcdf.f', and use 'test.f' as an example. If you have questions about NetCDF, direct them to 'netcdfgroup@unidata.ucar.edu'. Send questions about the data sets and 'uwmcdf.f' to 'uwmcoads@niteroi.gsfc.nasa.gov'. Good Luck!