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:

Configure and compile the code:
  cd build
  ../../../tools/genmake2 -mods ../code [-of my_platform_optionFile]
 [make Clean]
  make depend
  make
  cd ..

To run:
  cd run
  ln -s ../input/* .
  ../input/prepare_run
  ln -s ../build/mitgcmuv .
  ./mitgcmuv > output.txt
  cd ..

There is comparison output in the directory:
  results/output.txt

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