/[MITgcm]/MITgcm_contrib/gael/verification/README
ViewVC logotype

Annotation of /MITgcm_contrib/gael/verification/README

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


Revision 1.1 - (hide annotations) (download)
Thu Oct 4 02:33:57 2012 UTC (12 years, 9 months ago) by gforget
Branch: MAIN
- add documentation in README.
- update setup_these_exps.csh according to global_oce_* revisions.

1 gforget 1.1
2     (last edit : oct. 3rd, 2012)
3    
4     ---------------------------------------------------------------
5     A) setup the experiments (incl. llc90 and cs32 core2.cnyf runs)
6     ---------------------------------------------------------------
7    
8     0) get MITgcm as explained @ http://mitgcm.org/public/source_code.html
9     1) get the MITgcm_contrib/gael/verification/setup_these_exps.csh c-shell
10     setup script e.g. by typing
11     cvs co MITgcm_contrib/gael/verification/setup_these_exps.csh
12     mv MITgcm_contrib/gael/verification/setup_these_exps.csh .
13     Unless you already had something in MITgcm_contrib you may want
14     to remove that directory. Hereafter we wont need it anymore.
15     2) execute the setup script by typing
16     source ./setup_these_exps.csh
17     A pre-requisite is that you are logged in to the MITgcm
18     cvs server. If you completed step1, you indeed already are.
19     If otherwise, see http://mitgcm.org/public/source_code.html
20     3) step2 creates a directory global_oce_tmp_download that
21     contains the experiments directories. Move them to
22     MITgcm/verification and cd to that location. Once you
23     have done this succesfully you may want to remove
24     global_oce_tmp_download. We wont need it anymore.
25     4) exectute MITgcm with testreport. Two examples from one machine.
26     To run the cs32 test on one cpu :
27     ./testreport -t global_oce_cs32
28     And to run the llc90 test on 12 cpus, using mpi
29     ./testreport -match 6 -of=../tools/build_options/linux_amd64_gfortran -MPI 12 -command 'mpirun -np TR_NPROC ./mitgcmuv' -t global_oce_llc90
30     The optfile may be swaped for one that better suits your machine.
31     5) for llc90 experiment testreport should show something like
32     Y Y Y Y> 6<16 16 12 12 16 16 13 11 12 11 11 11 12 13 10 11 . . pass global_oce_llc90
33     Y Y Y N .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. . . N/O global_oce_llc90.core2
34     Y Y Y N .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. . . N/O global_oce_llc90.ecco_v4
35     Y Y Y N .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. . . N/O global_oce_llc90.ecmwf
36     implying that the main experiment ran as expected in global_oce_llc90/run. In contrast
37     the sub-experiments, by default, fail by omission of surface forcing fields. This
38     omission saves disk space and download time. In case you want to run the sub-experiments,
39     you will need to obtain additional inputs. Contact us about this if applies.
40    
41     -----------------------------------------------------------------------
42     B) in case you want to change stuff on your end, or for troubleshooting
43     -----------------------------------------------------------------------
44    
45     0) to run the core2, ecmwf, and ecco_v4 subexperiments you will need
46     extra stuff in global_oce_input_fields. Contact us if need be.
47    
48     1) In linking the experiments to one another we rely on 'build/genmake_local' and
49     'input*/prepare_run' which may be worth a special mention, at least to new MITgcm users.
50    
51     1.1) most importantly : if you remove these files, the exps wont run or even compile.
52     1.2) build/genmake_local specifies the use of xmakedepend (since the default
53     cant handle so many files) and in global_oce_cs32 it points to
54     "../../global_oce_llc90/code/" If you move global_oce_llc90 away from
55     global_oce_cs32 you will need to edit that path in genmake_local.
56     1.3) in analogy input*/prepare_run are a set of instructions that "testreport"
57     will execute before running MITgcm, to link all of the proper inputs.
58     And again the experiments form a self-consistent group, such that
59     e.g. global_oce_cs32 will get shared files from global_oce_llc90. If you move
60     the directories appart, you will need to edit the paths in input*/prepare_run
61     1.4) the logic we followed in linking exps to one another :
62     - forward subexperiments : get local namelists then run input/prepare_run
63     - adjoint subexperiments : get input_ad.x/namelists then run corresponding forward
64     subexperiment input.x/prepare_run (that itself ultimately runs input/prepare_run)
65    
66     2) In a couple .h files (that you find in the build directory after compiling)
67     small size parameters are used as a default (to save memory of course)
68     and they can become limiting in certain cases :
69     - you may want to integrate the model beyond a few time steps. You will need to
70     edit ecco_cost.h, increase nchklev_1, nchklev_2, nchklev_3 and recompile.
71     - you may want to use pkg/profiles (i.e. process insitu data via data.profiles).
72     You will need to edit profiles.h to increase NOBSGLOB, and recompile.
73    
74     3) To run the adjoint subexperiments you need the taf/tamc software/license.
75    
76    
77     ---------------------------------------------------------------
78     Cheers,
79     Gael
80     ---------------------------------------------------------------

  ViewVC Help
Powered by ViewVC 1.1.22