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 run_dir   = ${cwd}/run
  set ROOT      = ${cwd}/../../

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

To run:
  cd ${run_dir}
  cp ../input/* .
  ${build_dir}/mitgcmuv

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