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