verification/global_ocean.90x40x15/README

Example: "4x4 Global Simulation with Seasonal Forcing"
============================================
(see also similar set-up in: verification/tutorial_global_oce_latlon/)

From verification/global_ocean.90x40x15 dir:

To apply the changes to the default configuration of MITgcmUV:
Configure and compile the code:
  cd build
  ../../../tools/genmake2 -mods='../code'
 [make Clean]
  make depend
  make
  cd ..
To run the code:
  cd input
  ./prepare_run
  ../build/mitgcmuv > output.txt
  cd ..

There is comparison output in directory:
  (verification/global_ocean.90x40x1/) results

Comments:
o The input data is real*4.
o The surface fluxes are derived from monthly means of the NCEP climatology;
  - a matlab script is provided that created the surface flux data files from
    the original NCEP data: ncep2global_ocean.m in the diags_matlab directory,
    needs editing to adjust search paths.
o matlab scripts that make a simple diagnostic (barotropic stream function,
  overturning stream functions, averaged hydrography etc.) is provided in
  verification/tutorial_global_oce_latlon/diags_matlab:
  - mit_loadglobal is the toplevel script that run all other scripts
  - mit_globalmovie animates theta, salinity, and 3D-velocity field for
    a layer "iz", if "meanfields=0"

--------------------------------------------
Additional example:
  similar set-up, with the same executable, and using pkg/dwnslp:
to run this 2nd example:
  cd input.dwnslp
  ln -s ../input/* .
  ../input/prepare_run
  ../build/mitgcmuv > output.dwnslp.txt
  cd ..

============================================
Adjoint set-up example:

Configure and compile the code:
  cd build
  ../../../tools/genmake2 -mods='../code_ad'
 [make Clean]
  make depend
  make adall
  cd ..
To run the code:
  cd input_ad
  ./prepare_run
  ../build/mitgcmuv_ad > output_adm.txt
  cd ..
1	mlosch	1.1	Example: "4x4 Global Simulation with Seasonal Forcing"
2	jmc	1.2	============================================
3			(see also similar set-up in: verification/tutorial_global_oce_latlon/)
4
5			From verification/global_ocean.90x40x15 dir:
6	mlosch	1.1
7			To apply the changes to the default configuration of MITgcmUV:
8			Configure and compile the code:
9	jmc	1.2	cd build
10			../../../tools/genmake2 -mods='../code'
11			[make Clean]
12	mlosch	1.1	make depend
13			make
14	jmc	1.2	cd ..
15	mlosch	1.1	To run the code:
16	jmc	1.2	cd input
17			./prepare_run
18			../build/mitgcmuv > output.txt
19			cd ..
20	mlosch	1.1
21			There is comparison output in directory:
22	jmc	1.2	(verification/global_ocean.90x40x1/) results
23	mlosch	1.1
24			Comments:
25			o The input data is real*4.
26			o The surface fluxes are derived from monthly means of the NCEP climatology;
27	jmc	1.2	- a matlab script is provided that created the surface flux data files from
28	mlosch	1.1	the original NCEP data: ncep2global_ocean.m in the diags_matlab directory,
29			needs editing to adjust search paths.
30			o matlab scripts that make a simple diagnostic (barotropic stream function,
31			overturning stream functions, averaged hydrography etc.) is provided in
32	jmc	1.2	verification/tutorial_global_oce_latlon/diags_matlab:
33	mlosch	1.1	- mit_loadglobal is the toplevel script that run all other scripts
34			- mit_globalmovie animates theta, salinity, and 3D-velocity field for
35			a layer "iz", if "meanfields=0"
36
37	jmc	1.2	--------------------------------------------
38			Additional example:
39			similar set-up, with the same executable, and using pkg/dwnslp:
40			to run this 2nd example:
41			cd input.dwnslp
42			ln -s ../input/* .
43			../input/prepare_run
44			../build/mitgcmuv > output.dwnslp.txt
45			cd ..
46
47			============================================
48			Adjoint set-up example:
49
50			Configure and compile the code:
51			cd build
52			../../../tools/genmake2 -mods='../code_ad'
53			[make Clean]
54			make depend
55			make adall
56			cd ..
57			To run the code:
58			cd input_ad
59			./prepare_run
60			../build/mitgcmuv_ad > output_adm.txt
61			cd ..