Annotation of /MITgcm/verification/exp4/README

Example: "Flow over a bump with Open Boundaries and passive tracers"
====================================================================

default paths are (as used in testreport):
  set build_dir = ${cwd}/build
  set exe       = ${cwd}/build
  set ROOT      = ${cwd}/../../

Configure and compile the code:
  mkdir ${build_dir}
  cd ${build_dir}
  ${ROOT}/tools/genmake2 -mods=${cwd}/code
  make depend
  make

To run:
  mkdir ${exe_dir}
  cd ${exe_dir}
  cp ${cwd}/input/* .
  ${build_dir}/mitgcmuv

There is comparison output in the directory:
 ..${cwd}/results

Comments:
The input data is real*8.

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.
1	mlosch	1.5	Example: "Flow over a bump with Open Boundaries and passive tracers"
2			====================================================================
3	adcroft	1.2
4	mlosch	1.5	default paths are (as used in testreport):
5			set build_dir = ${cwd}/build
6			set exe = ${cwd}/build
7			set ROOT = ${cwd}/../../
8	adcroft	1.2
9			Configure and compile the code:
10	mlosch	1.5	mkdir ${build_dir}
11			cd ${build_dir}
12			${ROOT}/tools/genmake2 -mods=${cwd}/code
13	adcroft	1.2	make depend
14			make
15
16			To run:
17	mlosch	1.5	mkdir ${exe_dir}
18			cd ${exe_dir}
19			cp ${cwd}/input/* .
20			${build_dir}/mitgcmuv
21	adcroft	1.2
22			There is comparison output in the directory:
23	mlosch	1.5	..${cwd}/results
24	adcroft	1.2
25			Comments:
26	adcroft	1.3	The input data is real*8.
27	adcroft	1.2
28	mlosch	1.5	This experiment is a channel with topography and four open
29			boundaries. Salinity is not dynamically active in this experiment
30			(linear equation of state with sBeta=0). Different kinds of open
31			boundary values are used: zonal (x-)velocity U is prescribed at all
32			open boundaries with values that are read from data files (specified
33			in data.obcs); meridional (y-)velocity V is set to zero on all
34			boundaries, and temperature to tRef(z), both in obcs_calc.F, this is
35			the default behavior; at the western boundary, salinity values are
36			used for salinity and one passive tracer in the same way. Salinity is
37			set to sLev at all other boundaries, while a (nearly) homogeneous
38			v.Neumann condition is applied to the passive tracer (the latter is
39	jmc	1.6	the default in obcs_calc.F), with a relaxation (using pkg rbcs) in
40			the Eastern part of the channel. Open boundary parameters are set in
41	mlosch	1.5	data.obcs.