/[MITgcm]/MITgcm/verification/adjustment.cs-32x32x1/README
ViewVC logotype

Diff of /MITgcm/verification/adjustment.cs-32x32x1/README

Parent Directory Parent Directory | Revision Log Revision Log | View Revision Graph Revision Graph | View Patch Patch

revision 1.1 by jmc, Sun Apr 26 01:40:31 2009 UTC revision 1.2 by jmc, Tue May 25 22:00:20 2010 UTC
# Line 1  Line 1 
1  Simple 1 layer, Barotropic adjustment on the Sphere, using the  Simple 1 layer, Barotropic adjustment on the Sphere, using the
2  cubed-sphere grid 32x32x32                  cubed-sphere grid 32x32x32
3    Contains also a "minimal" test case (just compile eesupp/src + pkgs)
4                    that does not do much.
5  =================================================================  =================================================================
6    
7  General Description:  General Description:
8  * using the same executable, 2 set-up can be tested, corresponding  * using the same executable, 2 set-up can be tested, corresponding
9    to input dir. "input" and "input.nlfs".    to input dir. "input" and "input.nlfs".
10  * Default set-up (input & parameter files in dir "input"):  * Default set-up (input & parameter files in dir "input"):
11    Oceanic set-up with flat bottom and a large quasi-rectangular    Oceanic set-up with flat bottom and a large quasi-rectangular
12    continent is initially at rest. An initial free-surface large-scale    continent is initially at rest. An initial free-surface large-scale
13    anomaly centered at the equator triggers a barotropic adjustment    anomaly centered at the equator triggers a barotropic adjustment
14    and generates External Inertial-Gravity waves (Poincare waves).    and generates External Inertial-Gravity waves (Poincare waves).
15    Use linear Free-Surface and linear dynamics (no momentum advection)    Use linear Free-Surface and linear dynamics (no momentum advection)
16  * Additional set-up (input & parameter files in dir "input.nlfs"):  * Additional set-up (input & parameter files in dir "input.nlfs"):
17    Atmospheric set-up, without orography, initially at rest.    Atmospheric set-up, without orography, initially at rest.
18    An initial large-scale surface pressure anomaly generated pure    An initial large-scale surface pressure anomaly generated pure
19    external gravity waves.    external gravity waves.
20    Use non-linear Free-Surface, linear dynamics (no momentum advection)    Use non-linear Free-Surface, linear dynamics (no momentum advection)
# Line 21  General Description: Line 23  General Description:
23  IMPORTANT: For the purpose of testing multiple tiles and "blank-tiles":  IMPORTANT: For the purpose of testing multiple tiles and "blank-tiles":
24  * Use multiple tiles (8) per cube-face (tile size: 16x8),  * Use multiple tiles (8) per cube-face (tile size: 16x8),
25    which results in a total of 48 tiles:    which results in a total of 48 tiles:
26      code/SIZE.h      code/SIZE.h
27      code/W2_EXCH2_TOPOLOGY.h : to replace pkg/exch2/W2_EXCH2_TOPOLOGY.h      code/W2_EXCH2_TOPOLOGY.h : to replace pkg/exch2/W2_EXCH2_TOPOLOGY.h
28                                 ( = 6-tiles default version )                                 ( = 6-tiles default version )
29      code/w2_e2setup.F        : to replace pkg/exch2/W2_EXCH2_TOPOLOGY.h      code/w2_e2setup.F        : to replace pkg/exch2/W2_EXCH2_TOPOLOGY.h
# Line 29  IMPORTANT: For the purpose of testing mu Line 31  IMPORTANT: For the purpose of testing mu
31          MITgcm/utils/exch2/matlab-topology-generator/driver.m          MITgcm/utils/exch2/matlab-topology-generator/driver.m
32  * The oceanic-set-up contains 4 empty tiles (tiles: 11,12,13,14)  * The oceanic-set-up contains 4 empty tiles (tiles: 11,12,13,14)
33    associated with the large continent.    associated with the large continent.
34    This gives the opportunity to test the "blank-tiles" option of    This gives the opportunity to test the "blank-tiles" option of
35    the EXCH2 pkg. An MPI version of this set-up is available to    the EXCH2 pkg. An MPI version of this set-up is available to
36    test this "blank-tiles" option:    test this "blank-tiles" option:
37      code/SIZE.h_mpi          : to replace code/SIZE.h      code/SIZE.h_mpi          : to replace code/SIZE.h
38      code/W2_EXCH2_TOPOLOGY.h : to replace pkg/exch2/W2_EXCH2_TOPOLOGY.h      code/W2_EXCH2_TOPOLOGY.h : to replace pkg/exch2/W2_EXCH2_TOPOLOGY.h
39      code/w2_e2setup.F_mpi    : to replace code/CPP_EEOPTIONS.h_mpi      code/w2_e2setup.F_mpi    : to replace code/CPP_EEOPTIONS.h_mpi
40        generated with matlab script:        generated with matlab script:
41          MITgcm/utils/exch2/matlab-topology-generator/driver.m          MITgcm/utils/exch2/matlab-topology-generator/driver.m
42        using the blank-list file: code/blanklist.txt        using the blank-list file: code/blanklist.txt
43      code/CPP_EEOPTIONS.h_mpi : to replace eesupp/inc/CPP_EEOPTIONS.h      code/CPP_EEOPTIONS.h_mpi : to replace eesupp/inc/CPP_EEOPTIONS.h
44    However, this particular (MPI) executable cannot be used for the    However, this particular (MPI) executable cannot be used for the
45    atmospheric set-up (input.nlfs) and, in this case, an error    atmospheric set-up (input.nlfs) and, in this case, an error
46    from S/R EXCH2_CHECK_DEPTHS will stop the execution.    from S/R EXCH2_CHECK_DEPTHS will stop the execution.
47      
48  Forcing : none  Forcing : none
49  Input Files (initial conditions) :  Input Files (initial conditions) :
50    
51  Comments:  Comments:
52    
53    =================================================================
54    "minimal" test case:
55     provide an example of a minimal set-up which only compiles eesupp/src
56     and the 2 pkgs (exch2 & debug) which don't need model/src & inc.
57    
58    code_min:
59      CPP_OPTIONS.h (standard version, needed here since model/inc is not linked)
60      packages.conf (2 pkgs: exch2 & debug)
61      main.F        (copied from eesupp/src, but skip the call to THE_MODEL_MAIN)
62      SIZE.h        (same as code/SIZE.h)
63      SIZE.h_mpi    (same as code/SIZE.h_mpi)
64    
65    input_min
66      eedataa       (standard version)
67      eedata.mth    (to test running 2 threads)
68      data.exch2.mpi (to test blank-tiles with exch2 and MPI built)
69    
70    to build:
71     in order not to compile model/src, need to:
72     either put (in build dir) a "genmake_local" file with STANDARDDIRS="eesupp"
73     - or -
74     use genmake2 command line: "genmake2 -standarddirs eesupp" -mods ../code_min"
75    
76    =================================================================

Legend:
Removed from v.1.1  
changed lines
  Added in v.1.2

  ViewVC Help
Powered by ViewVC 1.1.22