Annotation of /MITgcm/verification/tutorial_global_oce_in_p/README

Tutorial Example: "P coordinate Global Ocean"
(Global Ocean Simulation at 4o Resolution in Pressure Coordinates)
==================================================================
(formerly "global_ocean_pressure")

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

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

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

Comments:
o the set up is similar to that of tutorial_global_oce_latlon
o the code directory contains calc_phi_hyd.F, where the potential is computed
  according to the more natural finite volume discretization. Finite difference
  discretization is energy conserving, but the representation of the "fixed"
  surface (interface ocean-atmosphere) is less consistent.
o the code directory also contains dynamics.F which calls
  remove_mean_rl.F, a generic routine, to remove the mean from the
  diagnostic variable phiHydLow (sea surface height/gravity in pressure
  coordinates)

changes: 07 Feb. 2003 (jmc):
o find difficult to maintain the local version of dynamics.F up to date.
  therefore, has been remove from the code directory.
  One can recover the same version (but up to date) simply
  by activating the commented lines [between lines Cml( and Cml) ],
  at the end of the standard version of dynamics.F
o finite volume form of calc_phi_hyd.F is now a standard option.
  only needs to set integr_GeoPot=1 in file "data" to select this form.
1	jmc	1.2	Tutorial Example: "P coordinate Global Ocean"
2	jmc	1.1	(Global Ocean Simulation at 4o Resolution in Pressure Coordinates)
3			==================================================================
4	jmc	1.2	(formerly "global_ocean_pressure")
5	jmc	1.1
6			Configure and compile the code:
7			cd build
8			../../../tools/genmake2 -mods ../code [-of my_platform_optionFile]
9			make depend
10			make
11	jmc	1.2	cd ..
12	jmc	1.1
13			To run:
14	jmc	1.2	cd run
15	jmc	1.1	ln -s ../input/* .
16	jmc	1.2	ln -s ../build/mitgcmuv .
17	jmc	1.1	./mitgcmuv > output.txt
18	jmc	1.2	cd ..
19	jmc	1.1
20			There is comparison output in the directory:
21			results/output.txt
22
23			Comments:
24	jmc	1.2	o the set up is similar to that of tutorial_global_oce_latlon
25	jmc	1.1	o the code directory contains calc_phi_hyd.F, where the potential is computed
26			according to the more natural finite volume discretization. Finite difference
27			discretization is energy conserving, but the representation of the "fixed"
28			surface (interface ocean-atmosphere) is less consistent.
29			o the code directory also contains dynamics.F which calls
30			remove_mean_rl.F, a generic routine, to remove the mean from the
31			diagnostic variable phiHydLow (sea surface height/gravity in pressure
32	jmc	1.2	coordinates)
33	jmc	1.1
34			changes: 07 Feb. 2003 (jmc):
35			o find difficult to maintain the local version of dynamics.F up to date.
36			therefore, has been remove from the code directory.
37	jmc	1.2	One can recover the same version (but up to date) simply
38	jmc	1.1	by activating the commented lines [between lines Cml( and Cml) ],
39			at the end of the standard version of dynamics.F
40			o finite volume form of calc_phi_hyd.F is now a standard option.
41			only needs to set integr_GeoPot=1 in file "data" to select this form.