verification/adjustment.cs-32x32x1/README

Simple 1 layer, Barotropic adjustment on the Sphere, using the 
cubed-sphere grid 32x32x32
=================================================================

General Description:
* using the same executable, 2 set-up can be tested, corresponding 
  to input dir. "input" and "input.nlfs".
* Default set-up (input & parameter files in dir "input"):
  Oceanic set-up with flat bottom and a large quasi-rectangular 
  continent is initially at rest. An initial free-surface large-scale 
  anomaly centered at the equator triggers a barotropic adjustment 
  and generates External Inertial-Gravity waves (Poincare waves).
  Use linear Free-Surface and linear dynamics (no momentum advection)
* Additional set-up (input & parameter files in dir "input.nlfs"):
  Atmospheric set-up, without orography, initially at rest. 
  An initial large-scale surface pressure anomaly generated pure
  external gravity waves.
  Use non-linear Free-Surface, linear dynamics (no momentum advection)
  without rotation.

IMPORTANT: For the purpose of testing multiple tiles and "blank-tiles":
* Use multiple tiles (8) per cube-face (tile size: 16x8),
  which results in a total of 48 tiles:
    code/SIZE.h 
    code/W2_EXCH2_TOPOLOGY.h : to replace pkg/exch2/W2_EXCH2_TOPOLOGY.h
                               ( = 6-tiles default version )
    code/w2_e2setup.F        : to replace pkg/exch2/W2_EXCH2_TOPOLOGY.h
  the last 2 files ave been generated with matlab script:
        MITgcm/utils/exch2/matlab-topology-generator/driver.m
* The oceanic-set-up contains 4 empty tiles (tiles: 11,12,13,14)
  associated with the large continent.
  This gives the opportunity to test the "blank-tiles" option of 
  the EXCH2 pkg. An MPI version of this set-up is available to 
  test this "blank-tiles" option:
    code/SIZE.h_mpi          : to replace code/SIZE.h
    code/W2_EXCH2_TOPOLOGY.h : to replace pkg/exch2/W2_EXCH2_TOPOLOGY.h
    code/w2_e2setup.F_mpi    : to replace code/CPP_EEOPTIONS.h_mpi
      generated with matlab script: 
        MITgcm/utils/exch2/matlab-topology-generator/driver.m
      using the blank-list file: code/blanklist.txt
    code/CPP_EEOPTIONS.h_mpi : to replace eesupp/inc/CPP_EEOPTIONS.h
  However, this particular (MPI) executable cannot be used for the 
  atmospheric set-up (input.nlfs) and, in this case, an error 
  from S/R EXCH2_CHECK_DEPTHS will stop the execution.
  
Forcing : none
Input Files (initial conditions) :

Comments:
1	Simple 1 layer, Barotropic adjustment on the Sphere, using the
2	cubed-sphere grid 32x32x32
3	=================================================================
4
5	General Description:
6	* using the same executable, 2 set-up can be tested, corresponding
7	to input dir. "input" and "input.nlfs".
8	* Default set-up (input & parameter files in dir "input"):
9	Oceanic set-up with flat bottom and a large quasi-rectangular
10	continent is initially at rest. An initial free-surface large-scale
11	anomaly centered at the equator triggers a barotropic adjustment
12	and generates External Inertial-Gravity waves (Poincare waves).
13	Use linear Free-Surface and linear dynamics (no momentum advection)
14	* Additional set-up (input & parameter files in dir "input.nlfs"):
15	Atmospheric set-up, without orography, initially at rest.
16	An initial large-scale surface pressure anomaly generated pure
17	external gravity waves.
18	Use non-linear Free-Surface, linear dynamics (no momentum advection)
19	without rotation.
20
21	IMPORTANT: For the purpose of testing multiple tiles and "blank-tiles":
22	* Use multiple tiles (8) per cube-face (tile size: 16x8),
23	which results in a total of 48 tiles:
24	code/SIZE.h
25	code/W2_EXCH2_TOPOLOGY.h : to replace pkg/exch2/W2_EXCH2_TOPOLOGY.h
26	( = 6-tiles default version )
27	code/w2_e2setup.F : to replace pkg/exch2/W2_EXCH2_TOPOLOGY.h
28	the last 2 files ave been generated with matlab script:
29	MITgcm/utils/exch2/matlab-topology-generator/driver.m
30	* The oceanic-set-up contains 4 empty tiles (tiles: 11,12,13,14)
31	associated with the large continent.
32	This gives the opportunity to test the "blank-tiles" option of
33	the EXCH2 pkg. An MPI version of this set-up is available to
34	test this "blank-tiles" option:
35	code/SIZE.h_mpi : to replace code/SIZE.h
36	code/W2_EXCH2_TOPOLOGY.h : to replace pkg/exch2/W2_EXCH2_TOPOLOGY.h
37	code/w2_e2setup.F_mpi : to replace code/CPP_EEOPTIONS.h_mpi
38	generated with matlab script:
39	MITgcm/utils/exch2/matlab-topology-generator/driver.m
40	using the blank-list file: code/blanklist.txt
41	code/CPP_EEOPTIONS.h_mpi : to replace eesupp/inc/CPP_EEOPTIONS.h
42	However, this particular (MPI) executable cannot be used for the
43	atmospheric set-up (input.nlfs) and, in this case, an error
44	from S/R EXCH2_CHECK_DEPTHS will stop the execution.
45
46	Forcing : none
47	Input Files (initial conditions) :
48
49	Comments: