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

Contents of /MITgcm_contrib/gael/verification/README

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


Revision 1.2 - (show annotations) (download)
Wed Oct 10 20:44:59 2012 UTC (12 years, 9 months ago) by heimbach
Branch: MAIN
Changes since 1.1: +5 -2 lines
Add a piece of info.

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 to
25 MITgcm/verification and cd to that location. Once you
26 have done this succesfully you may want to remove
27 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
51 1) In linking the experiments to one another we rely on 'build/genmake_local' and
52 'input*/prepare_run' which may be worth a special mention, at least to new MITgcm users.
53
54 1.1) most importantly : if you remove these files, the exps wont run or even compile.
55 1.2) build/genmake_local specifies the use of xmakedepend (since the default
56 cant handle so many files) and in global_oce_cs32 it points to
57 "../../global_oce_llc90/code/" If you move global_oce_llc90 away from
58 global_oce_cs32 you will need to edit that path in genmake_local.
59 1.3) in analogy input*/prepare_run are a set of instructions that "testreport"
60 will execute before running MITgcm, to link all of the proper inputs.
61 And again the experiments form a self-consistent group, such that
62 e.g. global_oce_cs32 will get shared files from global_oce_llc90. If you move
63 the directories appart, you will need to edit the paths in input*/prepare_run
64 1.4) the logic we followed in linking exps to one another :
65 - forward subexperiments : get local namelists then run input/prepare_run
66 - adjoint subexperiments : get input_ad.x/namelists then run corresponding forward
67 subexperiment input.x/prepare_run (that itself ultimately runs input/prepare_run)
68
69 2) In a couple .h files (that you find in the build directory after compiling)
70 small size parameters are used as a default (to save memory of course)
71 and they can become limiting in certain cases :
72 - you may want to integrate the model beyond a few time steps. You will need to
73 edit ecco_cost.h, increase nchklev_1, nchklev_2, nchklev_3 and recompile.
74 - you may want to use pkg/profiles (i.e. process insitu data via data.profiles).
75 You will need to edit profiles.h to increase NOBSGLOB, and recompile.
76
77 3) To run the adjoint subexperiments you need the taf/tamc software/license.
78
79
80 ---------------------------------------------------------------
81 Cheers,
82 Gael
83 ---------------------------------------------------------------

  ViewVC Help
Powered by ViewVC 1.1.22