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	Example: "4x4 Global Simulation with Seasonal Forcing"
2	============================================
3	(see also similar set-up in: verification/tutorial_global_oce_latlon/)
4
5	From verification/global_ocean.90x40x15 dir:
6
7	To apply the changes to the default configuration of MITgcmUV:
8	Configure and compile the code:
9	cd build
10	../../../tools/genmake2 -mods='../code'
11	[make Clean]
12	make depend
13	make
14	cd ..
15	To run the code:
16	cd input
17	./prepare_run
18	../build/mitgcmuv > output.txt
19	cd ..
20
21	There is comparison output in directory:
22	(verification/global_ocean.90x40x1/) results
23
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	- a matlab script is provided that created the surface flux data files from
28	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	verification/tutorial_global_oce_latlon/diags_matlab:
33	- 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	--------------------------------------------
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 ..