--- MITgcm/verification/exp4/README	1998/12/15 00:02:26	1.2
+++ MITgcm/verification/exp4/README	2010/04/15 15:58:00	1.7
@@ -1,28 +1,39 @@
-Example: "Flow over a bump with Open Boundaries"
-================================================
+Example: "Flow over a bump with Open Boundaries and passive tracers"
+====================================================================
 
-To apply the changes to the default configuration of MITgcmUV:
-  cp ../verification/exp4/code/SIZE.h ../model/inc/
-  cp ../verification/exp4/code/CPP_OPTIONS.h ../model/inc/
-  cp ../verification/exp4/code/CPP_EEOPTIONS.h ../eesupp/inc/
+default paths are (as used in testreport):
+  set build_dir = ${cwd}/build
+  set run_dir   = ${cwd}/run
+  set ROOT      = ${cwd}/../../
 
 Configure and compile the code:
-  cd bin
-  ../tools/genmake -makefile
+  cd ${build_dir}
+  ${ROOT}/tools/genmake2 -mods ../code
   make depend
   make
 
 To run:
-  cd ../exe
-  cp ../verification/exp4/input/* .
-  ./mitgcmuv
+  cd ${run_dir}
+  cp ../input/* .
+  ${build_dir}/mitgcmuv
 
 There is comparison output in the directory:
- ../verification/exp4/results
+ results      ( absolute path: ${run_dir}/../results )
 
 Comments:
-The input data is real*4.
+The input data is real*8.
 
-
-See the file doc/OpenBound.html or doc/OpenBound.txt for information
-on open boundaries
+This experiment is a channel with topography and four open
+boundaries. Salinity is not dynamically active in this experiment
+(linear equation of state with sBeta=0). Different kinds of open
+boundary values are used: zonal (x-)velocity U is prescribed at all
+open boundaries with values that are read from data files (specified
+in data.obcs); meridional (y-)velocity V is set to zero on all
+boundaries, and temperature to tRef(z), both in obcs_calc.F, this is
+the default behavior; at the western boundary, salinity values are
+used for salinity and one passive tracer in the same way. Salinity is
+set to sLev at all other boundaries, while a (nearly) homogeneous
+v.Neumann condition is applied to the passive tracer (the latter is
+the default in obcs_calc.F), with a relaxation (using pkg rbcs) in
+the Eastern part of the channel. Open boundary parameters are set in
+data.obcs.