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	jmc	1.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: