--- MITgcm_contrib/osse/README	2004/06/08 14:13:39	1.3
+++ MITgcm_contrib/osse/README	2004/06/08 19:52:21	1.5
@@ -32,11 +32,54 @@
 
 CONTENTS
 
-
-
 code: modifications to MITgcm to run in cyclindrical coordinates.  At
 the time of this writing, it requires checkpoint48 to compile and run.
 
+input: initialization and input files for MITgcm
+
 filter: source and data files to run the data assimilation and Kalman
 filter.
 
+utils: assorted Matlab m-files 
+
+EnKF: empty
+
+run: empty
+
+
+COMPILING AND RUNNING THE MODEL
+
+The following series of commands creates the MITgcm executable.  
+
+From the MITgcm root:
+
+cd verification/osse/build  
+../../../tools/genmake -mods=../code  # creates makefile
+make depend       # contructs Fortran code from model codebase
+make              # makes executable mitgcmuv
+
+Try a test run, while redirecting the standard output to a file.  The
+input directory contains files that should be present in the working
+directory when you run mitgcmuv.  It is recommended that you copy the
+input contents to a different directory for running -- mitgcmuv does
+not change them, but they can be lost in the multitudes of output
+files.
+
+The data assimilation code is made by typing ``make'' in the filter
+directory, which creates an executable named osse.  
+
+Before running osse, the initial ensemble needs to be set up by
+running the mkens script in verification/osse/da.  mkens creates the
+directories, symbolically links files necessary to run the model, and
+copies in the initial ensemble files.  osse should be run from the
+directory verification/osse/da/inits since it expects the ensemble
+members to be one directory above.  It also expects to have in its
+working directory the file iobsloc-003.txt, which contains the
+locations of the observations.  This file is located in
+verification/osse/da/inits.
+
+
+
+
+
+