/[MITgcm]/MITgcm/doc/README
ViewVC logotype

Contents of /MITgcm/doc/README

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


Revision 1.16 - (show annotations) (download)
Fri Aug 22 14:30:41 2003 UTC (20 years, 7 months ago) by edhill
Branch: MAIN
CVS Tags: checkpoint51k_post, checkpoint52l_pre, hrcube4, hrcube5, checkpoint57b_post, checkpoint52d_pre, checkpoint56b_post, checkpoint52j_pre, checkpoint51o_pre, checkpoint54d_post, checkpoint54e_post, checkpoint51l_post, checkpoint57d_post, checkpoint52l_post, checkpoint52k_post, checkpoint55, checkpoint54, checkpoint57, checkpoint56, checkpoint53, checkpoint52, checkpoint52f_post, checkpoint54f_post, checkpoint51f_post, checkpoint51t_post, checkpoint51n_post, checkpoint55i_post, checkpoint52i_pre, hrcube_1, hrcube_2, hrcube_3, checkpoint51s_post, checkpoint55c_post, checkpoint51j_post, checkpoint52e_pre, checkpoint52e_post, checkpoint51n_pre, checkpoint53d_post, checkpoint57a_post, checkpoint52b_pre, checkpoint54b_post, checkpoint51l_pre, checkpoint52m_post, checkpoint55g_post, checkpoint51q_post, checkpoint52b_post, checkpoint52c_post, checkpoint51h_pre, checkpoint57c_post, checkpoint52f_pre, checkpoint55d_post, checkpoint54a_pre, checkpoint53c_post, checkpoint55d_pre, checkpoint57c_pre, checkpoint55j_post, branchpoint-genmake2, checkpoint54a_post, checkpoint55h_post, checkpoint51r_post, checkpoint51i_post, checkpoint57e_post, checkpoint55b_post, checkpoint53a_post, checkpoint55f_post, checkpoint52d_post, checkpoint53g_post, eckpoint57e_pre, checkpoint52a_pre, checkpoint52i_post, checkpoint51i_pre, checkpoint52h_pre, checkpoint56a_post, checkpoint53f_post, checkpoint52j_post, branch-netcdf, checkpoint52n_post, checkpoint53b_pre, checkpoint56c_post, checkpoint57a_pre, checkpoint55a_post, checkpoint51o_post, checkpoint53b_post, checkpoint52a_post, checkpoint51g_post, ecco_c52_e35, checkpoint51m_post, checkpoint53d_pre, checkpoint55e_post, checkpoint54c_post, checkpoint51p_post, checkpoint51u_post
Branch point for: branch-genmake2, branch-nonh, tg2-branch, netcdf-sm0, checkpoint51n_branch
Changes since 1.15: +50 -1 lines
minor cleanup

1 $Header$
2
3 ================
4 === WARNING ===
5 ================
6
7
8 For MITgcm Users :
9
10 This directory (MITgcm/doc) does *NOT* contain the primary user
11 documentation for the MITgcm code. We strongly suggest that you forgo
12 the effort of downloading and "building" the documentation in the
13 different formats (pdf, html, etc.) and instead read and/or download
14 the documentation which is conveniently referenced from the main web
15 site at:
16
17 http://mitgcm.org
18
19
20
21 For MITgcm Developers:
22
23 If you wish to customize or extend the MITgcm code, this directory
24 contains a "HOWTO" document that tries to explain:
25
26 + where the code, documentation, and test/verification
27 data sets are arranged within the CVS repository;
28
29 + how to run the verification tests;
30
31 + how to get help from the core developers; and
32
33 + how to best integrate your work with the overall project.
34
35
36 The document is available in SGML source within this directory:
37
38 devel_HOWTO.sgml
39
40 and in various formats on our web site:
41
42 http://mitgcm.org/dev_docs/devel_HOWTO/
43
44
45
46
47 ======================================================================
48 === WARNING : The following has been superseeded by the on-line ===
49 === documentation at: http://mitgcm.org ===
50 ======================================================================
51
52
53 MITgcmUV Getting Started
54 ========================
55
56 o Introduction
57
58 This note is a guide to using the MIT General Circulation Model Ultra Verstaile
59 implementation, MITgmcUV. MITgcmUV is a Fortran code that implements the
60 algorithm described in Marshall et. al. 1997, Hill, Adcroft, ...
61 The MITgcmUV implementation is designed to work efficiently on all classes
62 of computer platforms. It can be used in both a single processor mode
63 and a parallel processor mode. Parallel processing can be either multi-threaded
64 shared memory such as that found on CRAY T90 machines or it can be multi-process
65 distributed memory. A set of "execution enviroment" support routines are
66 used to allow the same numerical code to run on top of a single-process, multi-threaded
67 or distributed multi-process configuration.
68
69 o Installing
70 To setup the model on a particular computer the code tree must be created
71 and appropriate compile and run scripts set up. For some platforms
72 the necessary scripts are included in the release - in this case follow
73 the steps below:
74
75 1. Extract MITgcmUV from the downloadable archive
76 tar -xvf cNN.tar
77
78 2. Create platform specific make file
79 For example on a Digital UNIX machine the script "genmake" can
80 be used as shown below
81
82 cd bin
83 ../tools/genmake
84 cp Makefile.alpha Makefile ( On Alpha machine)
85
86 3. Now create header file dependency entries
87 make depend
88
89 4. Compile code
90 make
91
92 5. To run the model with example data see the "README" in each of
93 the example experiments in ../verification/exp*/
94 e.g. ../verification/exp2/README
95
96
97 o Running
98
99 - Input and output files
100
101 Required files
102 ==============
103 The model is configured to look for two files with fixed names.
104 These files are called
105 "eedata" and "data".
106 The file eedata contains "execution environment" data. At present
107 this consists of a specification of the number of threads to
108 use in X and Y under multithreaded execution.
109
110 - Serial execution
111
112 - Parallel execution. MPI
113 mPx, nPy
114 dmpirun
115
116 - Parallel execution. Threads
117 nSx, nSy
118 setenv PARALLEL n
119 nTx=2, nTy=2
120
121 - Parallel execution. Hybrid
122
123 o Cutomising the code
124
125 Model structure
126 ===============
127 The "numerical" model is contained within a execution
128 environment support wrapper. This wrapper is designed
129 to provide a general framework for grid-point models.
130 MITgcmUV is a specific numerical model that uses the
131 framework.
132 Under this structure the model is split into
133 execution environment support code and conventional
134 numerical model code. The execution environment
135 support code is held under the "eesupp" directory.
136 The grid point model code is held under the
137 "model" directory.
138 Code execution actually starts in the eesupp
139 routines and not in the model routines. For this
140 reason the top level main.F is in the eesupp/src
141 directory. End-users should not need to worry about
142 this level. The top-level routine for the numerical
143 part of the code is in model/src/the_model_main.F.
144
145
146 o References
147 Web sites - HP
148 for doc Digital
149 SGI
150 Sun
151 Linux threads
152 CRAY multitasking
153 PPT notes

  ViewVC Help
Powered by ViewVC 1.1.22