Back to home page

MITgcm

 
 

    


Warning, /verification/adjustment.cs-32x32x1/README is written in an unsupported language. File is not indexed.

view on githubraw file Latest commit d6a28d35 on 2014-03-10 01:35:18 UTC
eb0a63ae1c Jean*0001 Simple 1 layer, Barotropic adjustment on the Sphere, using the
                0002                 cubed-sphere grid 32x32x32
                0003 Contains also a "minimal" test case (just compile eesupp/src + pkgs)
                0004                 that does not do much.
12ea9cd54a Jean*0005 =================================================================
                0006 
                0007 General Description:
eb0a63ae1c Jean*0008 * using the same executable, 2 set-up can be tested, corresponding
12ea9cd54a Jean*0009   to input dir. "input" and "input.nlfs".
                0010 * Default set-up (input & parameter files in dir "input"):
d6a28d3589 Jean*0011   Oceanic set-up initially at rest, with flat bottom and a large
                0012   quasi-rectangular continent. An initial free-surface large-scale
eb0a63ae1c Jean*0013   anomaly centered at the equator triggers a barotropic adjustment
12ea9cd54a Jean*0014   and generates External Inertial-Gravity waves (Poincare waves).
                0015   Use linear Free-Surface and linear dynamics (no momentum advection)
                0016 * Additional set-up (input & parameter files in dir "input.nlfs"):
eb0a63ae1c Jean*0017   Atmospheric set-up, without orography, initially at rest.
12ea9cd54a Jean*0018   An initial large-scale surface pressure anomaly generated pure
                0019   external gravity waves.
                0020   Use non-linear Free-Surface, linear dynamics (no momentum advection)
                0021   without rotation.
                0022 
                0023 IMPORTANT: For the purpose of testing multiple tiles and "blank-tiles":
                0024 * Use multiple tiles (8) per cube-face (tile size: 16x8),
                0025   which results in a total of 48 tiles:
eb0a63ae1c Jean*0026     code/SIZE.h
12ea9cd54a Jean*0027 * The oceanic-set-up contains 4 empty tiles (tiles: 11,12,13,14)
                0028   associated with the large continent.
eb0a63ae1c Jean*0029   This gives the opportunity to test the "blank-tiles" option of
                0030   the EXCH2 pkg. An MPI version of this set-up is available to
12ea9cd54a Jean*0031   test this "blank-tiles" option:
                0032     code/SIZE.h_mpi          : to replace code/SIZE.h
d6a28d3589 Jean*0033     input/data.exch2.mpi     : to be rename to data.exch2
12ea9cd54a Jean*0034     code/CPP_EEOPTIONS.h_mpi : to replace eesupp/inc/CPP_EEOPTIONS.h
eb0a63ae1c Jean*0035   However, this particular (MPI) executable cannot be used for the
                0036   atmospheric set-up (input.nlfs) and, in this case, an error
12ea9cd54a Jean*0037   from S/R EXCH2_CHECK_DEPTHS will stop the execution.
eb0a63ae1c Jean*0038 
d6a28d3589 Jean*0039 Forcing: none
                0040 Input Files (initial conditions):
                0041   generated using matlab script input/gendata.m
                0042  grid-files are linked using the script "input/prepare_run"
12ea9cd54a Jean*0043 
                0044 Comments:
eb0a63ae1c Jean*0045 
                0046 =================================================================
                0047 "minimal" test case:
                0048  provide an example of a minimal set-up which only compiles eesupp/src
                0049  and the 2 pkgs (exch2 & debug) which don't need model/src & inc.
                0050 
                0051 code_min:
                0052   CPP_OPTIONS.h (standard version, needed here since model/inc is not linked)
                0053   packages.conf (2 pkgs: exch2 & debug)
                0054   main.F        (copied from eesupp/src, but skip the call to THE_MODEL_MAIN)
                0055   SIZE.h        (same as code/SIZE.h)
                0056   SIZE.h_mpi    (same as code/SIZE.h_mpi)
                0057 
                0058 input_min
                0059   eedataa       (standard version)
                0060   eedata.mth    (to test running 2 threads)
                0061   data.exch2.mpi (to test blank-tiles with exch2 and MPI built)
                0062 
                0063 to build:
                0064  in order not to compile model/src, need to:
661b236b6d Jean*0065  either put (in build dir) a "genmake_local" file:
                0066  % cat > genmake_local <<EOF
                0067   STANDARDDIRS="eesupp"
                0068 EOF
eb0a63ae1c Jean*0069  - or -
661b236b6d Jean*0070  use genmake2 command line: "genmake2 -standarddirs eesupp -mods ../code_min"
eb0a63ae1c Jean*0071 
                0072 =================================================================