Annotation of /MITgcm/verification/natl_box/README

Example: Subtropical North Atlantic Subduction area
===================================================
- with KPP & shortwave heating
- no GMRedi

To apply the changes to the default configuration of MITgcmUV:
  cd bin
  ln -sf ../verification/natl_box/code/.genmakerc .
  ln -sf ../verification/natl_box/code/*.h .
  ln -sf ../verification/natl_box/code/*.F .

Configure and compile the code:
  cd ../bin
  ../tools/genmake -makefile
  make depend
  make

To run:
  cd ../exe
  cp ../verification/natl_box/input/* .
  mitgcmuv >&! output.txt

There is comparison output in:
diff output.txt ../verification/natl_box/results/output.txt | more

A FORTRAN program provides a verification procedure.
It is based on the boundary layer depth and will either issue:
'North Atlantic test passed.  KPPhbl file is unchanged.'
or:
'North Atlantic test failed.  KPPhbl file has changed.'

  cd ../exe
  ln -sf ../verification/natl_box/output/KPPhbl.001.001.data \
         KPPhbl_orig
  f77 ../verification/natl_box/output/comp_orig.F -o comp_orig
  comp_orig

N.B.: On ORIGIN 2000 use f77 -bytereclen 

A matlab script, comp_output.m, creates plots for
reference (c32) and new surface temperature, boundary layer depth,
meridional section of tracer diffusivities, and 
corresponding differences.

Comments:
The input data is real*4.
1	heimbach	1.1	Example: Subtropical North Atlantic Subduction area
2			===================================================
3			- with KPP & shortwave heating
4			- no GMRedi
5
6			To apply the changes to the default configuration of MITgcmUV:
7			cd bin
8	dimitri	1.3.10.1	ln -sf ../verification/natl_box/code/.genmakerc .
9			ln -sf ../verification/natl_box/code/*.h .
10			ln -sf ../verification/natl_box/code/*.F .
11	heimbach	1.1
12			Configure and compile the code:
13			cd ../bin
14			../tools/genmake -makefile
15			make depend
16			make
17
18			To run:
19			cd ../exe
20			cp ../verification/natl_box/input/* .
21	dimitri	1.3.10.1	mitgcmuv >&! output.txt
22	heimbach	1.1
23			There is comparison output in:
24	dimitri	1.3.10.1	diff output.txt ../verification/natl_box/results/output.txt \| more
25	heimbach	1.1
26			A FORTRAN program provides a verification procedure.
27			It is based on the boundary layer depth and will either issue:
28			'North Atlantic test passed. KPPhbl file is unchanged.'
29			or:
30			'North Atlantic test failed. KPPhbl file has changed.'
31
32			cd ../exe
33			ln -sf ../verification/natl_box/output/KPPhbl.001.001.data \
34			KPPhbl_orig
35			f77 ../verification/natl_box/output/comp_orig.F -o comp_orig
36			comp_orig
37
38			N.B.: On ORIGIN 2000 use f77 -bytereclen
39
40			A matlab script, comp_output.m, creates plots for
41			reference (c32) and new surface temperature, boundary layer depth,
42			meridional section of tracer diffusivities, and
43			corresponding differences.
44
45			Comments:
46			The input data is real*4.