| 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} |