21 |
<!-- CMIREDIR:whereToFindInfo: --> |
<!-- CMIREDIR:whereToFindInfo: --> |
22 |
\end{rawhtml} |
\end{rawhtml} |
23 |
|
|
24 |
A web site is maintained for release 2 (``Pelican'') of MITgcm: |
There is a web-archived support mailing list for the model that |
|
\begin{rawhtml} <A href=http://mitgcm.org/pelican/ target="idontexist"> \end{rawhtml} |
|
|
\begin{verbatim} |
|
|
http://mitgcm.org/pelican |
|
|
\end{verbatim} |
|
|
\begin{rawhtml} </A> \end{rawhtml} |
|
|
Here you will find an on-line version of this document, a |
|
|
``browsable'' copy of the code and a searchable database of the model |
|
|
and site, as well as links for downloading the model and |
|
|
documentation, to data-sources, and other related sites. |
|
|
|
|
|
There is also a web-archived support mailing list for the model that |
|
25 |
you can email at \texttt{MITgcm-support@mitgcm.org} or browse at: |
you can email at \texttt{MITgcm-support@mitgcm.org} or browse at: |
26 |
\begin{rawhtml} <A href=http://mitgcm.org/mailman/listinfo/mitgcm-support/ target="idontexist"> \end{rawhtml} |
\begin{rawhtml} <A href=http://mitgcm.org/mailman/listinfo/mitgcm-support/ target="idontexist"> \end{rawhtml} |
27 |
\begin{verbatim} |
\begin{verbatim} |
29 |
http://mitgcm.org/pipermail/mitgcm-support/ |
http://mitgcm.org/pipermail/mitgcm-support/ |
30 |
\end{verbatim} |
\end{verbatim} |
31 |
\begin{rawhtml} </A> \end{rawhtml} |
\begin{rawhtml} </A> \end{rawhtml} |
|
Essentially all of the MITgcm web pages can be searched using a |
|
|
popular web crawler such as Google or through our own search facility: |
|
|
\begin{rawhtml} <A href=http://mitgcm.org/mailman/htdig/ target="idontexist"> \end{rawhtml} |
|
|
\begin{verbatim} |
|
|
http://mitgcm.org/htdig/ |
|
|
\end{verbatim} |
|
|
\begin{rawhtml} </A> \end{rawhtml} |
|
|
%%% http://www.google.com/search?q=hydrostatic+site%3Amitgcm.org |
|
|
|
|
|
|
|
32 |
|
|
33 |
\section{Obtaining the code} |
\section{Obtaining the code} |
34 |
\label{sect:obtainingCode} |
\label{sect:obtainingCode} |
154 |
% mv MITgcm MITgcm_verif_basic |
% mv MITgcm MITgcm_verif_basic |
155 |
\end{verbatim} |
\end{verbatim} |
156 |
|
|
|
|
|
|
\subsection{Method 2 - Tar file download} |
|
|
\label{sect:conventionalDownload} |
|
|
|
|
|
If you do not have CVS on your system, you can download the model as a |
|
|
tar file from the web site at: |
|
|
\begin{rawhtml} <A href=http://mitgcm.org/download target="idontexist"> \end{rawhtml} |
|
|
\begin{verbatim} |
|
|
http://mitgcm.org/download/ |
|
|
\end{verbatim} |
|
|
\begin{rawhtml} </A> \end{rawhtml} |
|
|
The tar file still contains CVS information which we urge you not to |
|
|
delete; even if you do not use CVS yourself the information can help |
|
|
us if you should need to send us your copy of the code. If a recent |
|
|
tar file does not exist, then please contact the developers through |
|
|
the |
|
|
\begin{rawhtml} <A href="mailto:MITgcm-support@mitgcm.org"> \end{rawhtml} |
|
|
MITgcm-support@mitgcm.org |
|
|
\begin{rawhtml} </A> \end{rawhtml} |
|
|
mailing list. |
|
|
|
|
157 |
\subsubsection{Upgrading from an earlier version} |
\subsubsection{Upgrading from an earlier version} |
158 |
|
|
159 |
If you already have an earlier version of the code you can ``upgrade'' |
If you already have an earlier version of the code you can ``upgrade'' |
220 |
also means we can't tell what version of the code you are working |
also means we can't tell what version of the code you are working |
221 |
with. So please be sure you understand what you're doing. |
with. So please be sure you understand what you're doing. |
222 |
|
|
223 |
|
\subsection{Method 2 - Tar file download} |
224 |
|
\label{sect:conventionalDownload} |
225 |
|
|
226 |
|
If you do not have CVS on your system, you can download the model as a |
227 |
|
tar file from the web site at: |
228 |
|
\begin{rawhtml} <A href=http://mitgcm.org/download target="idontexist"> \end{rawhtml} |
229 |
|
\begin{verbatim} |
230 |
|
http://mitgcm.org/download/ |
231 |
|
\end{verbatim} |
232 |
|
\begin{rawhtml} </A> \end{rawhtml} |
233 |
|
The tar file still contains CVS information which we urge you not to |
234 |
|
delete; even if you do not use CVS yourself the information can help |
235 |
|
us if you should need to send us your copy of the code. If a recent |
236 |
|
tar file does not exist, then please contact the developers through |
237 |
|
the |
238 |
|
\begin{rawhtml} <A href="mailto:MITgcm-support@mitgcm.org"> \end{rawhtml} |
239 |
|
MITgcm-support@mitgcm.org |
240 |
|
\begin{rawhtml} </A> \end{rawhtml} |
241 |
|
mailing list. |
242 |
|
|
243 |
\section{Model and directory structure} |
\section{Model and directory structure} |
244 |
\begin{rawhtml} |
\begin{rawhtml} |
245 |
<!-- CMIREDIR:directory_structure: --> |
<!-- CMIREDIR:directory_structure: --> |
264 |
|
|
265 |
\begin{itemize} |
\begin{itemize} |
266 |
|
|
|
\item \texttt{bin}: this directory is initially empty. It is the |
|
|
default directory in which to compile the code. |
|
|
|
|
|
\item \texttt{diags}: contains the code relative to time-averaged |
|
|
diagnostics. It is subdivided into two subdirectories \texttt{inc} |
|
|
and \texttt{src} that contain include files (\texttt{*.h} files) and |
|
|
Fortran subroutines (\texttt{*.F} files), respectively. |
|
|
|
|
267 |
\item \texttt{doc}: contains brief documentation notes. |
\item \texttt{doc}: contains brief documentation notes. |
268 |
|
|
269 |
\item \texttt{eesupp}: contains the execution environment source code. |
\item \texttt{eesupp}: contains the execution environment source code. |
270 |
Also subdivided into two subdirectories \texttt{inc} and |
Also subdivided into two subdirectories \texttt{inc} and |
271 |
\texttt{src}. |
\texttt{src}. |
272 |
|
|
|
\item \texttt{exe}: this directory is initially empty. It is the |
|
|
default directory in which to execute the code. |
|
|
|
|
273 |
\item \texttt{model}: this directory contains the main source code. |
\item \texttt{model}: this directory contains the main source code. |
274 |
Also subdivided into two subdirectories \texttt{inc} and |
Also subdivided into two subdirectories \texttt{inc} and |
275 |
\texttt{src}. |
\texttt{src}. |
278 |
package corresponds to a subdirectory. For example, \texttt{gmredi} |
package corresponds to a subdirectory. For example, \texttt{gmredi} |
279 |
contains the code related to the Gent-McWilliams/Redi scheme, |
contains the code related to the Gent-McWilliams/Redi scheme, |
280 |
\texttt{aim} the code relative to the atmospheric intermediate |
\texttt{aim} the code relative to the atmospheric intermediate |
281 |
physics. The packages are described in detail in section 3. |
physics. The packages are described in detail in chapter \ref{chap.packagesI}. |
282 |
|
|
283 |
\item \texttt{tools}: this directory contains various useful tools. |
\item \texttt{tools}: this directory contains various useful tools. |
284 |
For example, \texttt{genmake2} is a script written in csh (C-shell) |
For example, \texttt{genmake2} is a script written in csh (C-shell) |
285 |
that should be used to generate your makefile. The directory |
that should be used to generate your makefile. The directory |
286 |
\texttt{adjoint} contains the makefile specific to the Tangent |
\texttt{adjoint} contains the makefile specific to the Tangent |
287 |
linear and Adjoint Compiler (TAMC) that generates the adjoint code. |
linear and Adjoint Compiler (TAMC) that generates the adjoint code. |
288 |
The latter is described in details in part V. |
The latter is described in detail in part \ref{chap.ecco}. |
289 |
|
This directory also contains the subdirectory build\_options, which |
290 |
|
contains the `optfiles' with the compiler options for the different |
291 |
|
compilers and machines that can run MITgcm. |
292 |
|
|
293 |
\item \texttt{utils}: this directory contains various utilities. The |
\item \texttt{utils}: this directory contains various utilities. The |
294 |
subdirectory \texttt{knudsen2} contains code and a makefile that |
subdirectory \texttt{knudsen2} contains code and a makefile that |
297 |
\texttt{matlab} subdirectory contains matlab scripts for reading |
\texttt{matlab} subdirectory contains matlab scripts for reading |
298 |
model output directly into matlab. \texttt{scripts} contains C-shell |
model output directly into matlab. \texttt{scripts} contains C-shell |
299 |
post-processing scripts for joining processor-based and tiled-based |
post-processing scripts for joining processor-based and tiled-based |
300 |
model output. |
model output. The subdirectory exch2 contains the code needed for |
301 |
|
the exch2 package to work with different combinations of domain |
302 |
|
decompositions. |
303 |
|
|
304 |
\item \texttt{verification}: this directory contains the model |
\item \texttt{verification}: this directory contains the model |
305 |
examples. See section \ref{sect:modelExamples}. |
examples. See section \ref{sect:modelExamples}. |
306 |
|
|
307 |
|
\item \texttt{jobs}: contains sample job scripts for running MITgcm. |
308 |
|
|
309 |
|
\item \texttt{lsopt}: Line search code used for optimization. |
310 |
|
|
311 |
|
\item \texttt{optim}: Interface between MITgcm and line search code. |
312 |
|
|
313 |
\end{itemize} |
\end{itemize} |
314 |
|
|
315 |
\section[Building MITgcm]{Building the code} |
\section[Building MITgcm]{Building the code} |