2 |
% $Name$ |
% $Name$ |
3 |
|
|
4 |
\section{Four Layer Baroclinic Ocean Gyre In Spherical Coordinates} |
\section{Four Layer Baroclinic Ocean Gyre In Spherical Coordinates} |
5 |
|
\label{www:tutorials} |
6 |
\label{sect:eg-fourlayer} |
\label{sect:eg-fourlayer} |
7 |
|
|
8 |
\bodytext{bgcolor="#FFFFFFFF"} |
\bodytext{bgcolor="#FFFFFFFF"} |
27 |
for four layers and in a spherical polar coordinate system. |
for four layers and in a spherical polar coordinate system. |
28 |
|
|
29 |
\subsection{Overview} |
\subsection{Overview} |
30 |
|
\label{www:tutorials} |
31 |
|
|
32 |
This example experiment demonstrates using the MITgcm to simulate |
This example experiment demonstrates using the MITgcm to simulate |
33 |
a baroclinic, wind-forced, ocean gyre circulation. The experiment |
a baroclinic, wind-forced, ocean gyre circulation. The experiment |
120 |
\end{figure} |
\end{figure} |
121 |
|
|
122 |
\subsection{Equations solved} |
\subsection{Equations solved} |
123 |
|
\label{www:tutorials} |
124 |
For this problem |
For this problem |
125 |
the implicit free surface, {\bf HPE} (see section \ref{sect:hydrostatic_and_quasi-hydrostatic_forms}) form of the |
the implicit free surface, {\bf HPE} (see section \ref{sect:hydrostatic_and_quasi-hydrostatic_forms}) form of the |
126 |
equations described in Marshall et. al \cite{marshall:97a} are |
equations described in Marshall et. al \cite{marshall:97a} are |
205 |
|
|
206 |
|
|
207 |
\subsection{Discrete Numerical Configuration} |
\subsection{Discrete Numerical Configuration} |
208 |
|
\label{www:tutorials} |
209 |
|
|
210 |
The domain is discretised with |
The domain is discretised with |
211 |
a uniform grid spacing in latitude and longitude |
a uniform grid spacing in latitude and longitude |
265 |
\ref{sect:finding_the_pressure_field}. |
\ref{sect:finding_the_pressure_field}. |
266 |
|
|
267 |
\subsubsection{Numerical Stability Criteria} |
\subsubsection{Numerical Stability Criteria} |
268 |
|
\label{www:tutorials} |
269 |
|
|
270 |
The Laplacian viscosity coefficient, $A_{h}$, is set to $400 m s^{-1}$. |
The Laplacian viscosity coefficient, $A_{h}$, is set to $400 m s^{-1}$. |
271 |
This value is chosen to yield a Munk layer width, |
This value is chosen to yield a Munk layer width, |
345 |
stability limit of 0.25. |
stability limit of 0.25. |
346 |
|
|
347 |
\subsection{Code Configuration} |
\subsection{Code Configuration} |
348 |
|
\label{www:tutorials} |
349 |
\label{SEC:eg_fourl_code_config} |
\label{SEC:eg_fourl_code_config} |
350 |
|
|
351 |
The model configuration for this experiment resides under the |
The model configuration for this experiment resides under the |
365 |
to these files associated with this experiment. |
to these files associated with this experiment. |
366 |
|
|
367 |
\subsubsection{File {\it input/data}} |
\subsubsection{File {\it input/data}} |
368 |
|
\label{www:tutorials} |
369 |
|
|
370 |
This file, reproduced completely below, specifies the main parameters |
This file, reproduced completely below, specifies the main parameters |
371 |
for the experiment. The parameters that are significant for this configuration |
for the experiment. The parameters that are significant for this configuration |
953 |
\begin{rawhtml}</PRE>\end{rawhtml} |
\begin{rawhtml}</PRE>\end{rawhtml} |
954 |
|
|
955 |
\subsubsection{File {\it input/data.pkg}} |
\subsubsection{File {\it input/data.pkg}} |
956 |
|
\label{www:tutorials} |
957 |
|
|
958 |
This file uses standard default values and does not contain |
This file uses standard default values and does not contain |
959 |
customisations for this experiment. |
customisations for this experiment. |
960 |
|
|
961 |
\subsubsection{File {\it input/eedata}} |
\subsubsection{File {\it input/eedata}} |
962 |
|
\label{www:tutorials} |
963 |
|
|
964 |
This file uses standard default values and does not contain |
This file uses standard default values and does not contain |
965 |
customisations for this experiment. |
customisations for this experiment. |
966 |
|
|
967 |
\subsubsection{File {\it input/windx.sin\_y}} |
\subsubsection{File {\it input/windx.sin\_y}} |
968 |
|
\label{www:tutorials} |
969 |
|
|
970 |
The {\it input/windx.sin\_y} file specifies a two-dimensional ($x,y$) |
The {\it input/windx.sin\_y} file specifies a two-dimensional ($x,y$) |
971 |
map of wind stress ,$\tau_{x}$, values. The units used are $Nm^{-2}$ (the |
map of wind stress ,$\tau_{x}$, values. The units used are $Nm^{-2}$ (the |
979 |
code for creating the {\it input/windx.sin\_y} file. |
code for creating the {\it input/windx.sin\_y} file. |
980 |
|
|
981 |
\subsubsection{File {\it input/topog.box}} |
\subsubsection{File {\it input/topog.box}} |
982 |
|
\label{www:tutorials} |
983 |
|
|
984 |
|
|
985 |
The {\it input/topog.box} file specifies a two-dimensional ($x,y$) |
The {\it input/topog.box} file specifies a two-dimensional ($x,y$) |
991 |
code for creating the {\it input/topog.box} file. |
code for creating the {\it input/topog.box} file. |
992 |
|
|
993 |
\subsubsection{File {\it code/SIZE.h}} |
\subsubsection{File {\it code/SIZE.h}} |
994 |
|
\label{www:tutorials} |
995 |
|
|
996 |
Two lines are customized in this file for the current experiment |
Two lines are customized in this file for the current experiment |
997 |
|
|
1018 |
\end{small} |
\end{small} |
1019 |
|
|
1020 |
\subsubsection{File {\it code/CPP\_OPTIONS.h}} |
\subsubsection{File {\it code/CPP\_OPTIONS.h}} |
1021 |
|
\label{www:tutorials} |
1022 |
|
|
1023 |
This file uses standard default values and does not contain |
This file uses standard default values and does not contain |
1024 |
customisations for this experiment. |
customisations for this experiment. |
1025 |
|
|
1026 |
|
|
1027 |
\subsubsection{File {\it code/CPP\_EEOPTIONS.h}} |
\subsubsection{File {\it code/CPP\_EEOPTIONS.h}} |
1028 |
|
\label{www:tutorials} |
1029 |
|
|
1030 |
This file uses standard default values and does not contain |
This file uses standard default values and does not contain |
1031 |
customisations for this experiment. |
customisations for this experiment. |
1032 |
|
|
1033 |
\subsubsection{Other Files } |
\subsubsection{Other Files } |
1034 |
|
\label{www:tutorials} |
1035 |
|
|
1036 |
Other files relevant to this experiment are |
Other files relevant to this experiment are |
1037 |
\begin{itemize} |
\begin{itemize} |
1044 |
\end{itemize} |
\end{itemize} |
1045 |
|
|
1046 |
\subsection{Running The Example} |
\subsection{Running The Example} |
1047 |
|
\label{www:tutorials} |
1048 |
\label{SEC:running_the_example} |
\label{SEC:running_the_example} |
1049 |
|
|
1050 |
\subsubsection{Code Download} |
\subsubsection{Code Download} |
1051 |
|
\label{www:tutorials} |
1052 |
|
|
1053 |
In order to run the examples you must first download the code distribution. |
In order to run the examples you must first download the code distribution. |
1054 |
Instructions for downloading the code can be found in section |
Instructions for downloading the code can be found in section |
1055 |
\ref{sect:obtainingCode}. |
\ref{sect:obtainingCode}. |
1056 |
|
|
1057 |
\subsubsection{Experiment Location} |
\subsubsection{Experiment Location} |
1058 |
|
\label{www:tutorials} |
1059 |
|
|
1060 |
This example experiments is located under the release sub-directory |
This example experiments is located under the release sub-directory |
1061 |
|
|
1063 |
{\it verification/exp2/ } |
{\it verification/exp2/ } |
1064 |
|
|
1065 |
\subsubsection{Running the Experiment} |
\subsubsection{Running the Experiment} |
1066 |
|
\label{www:tutorials} |
1067 |
|
|
1068 |
To run the experiment |
To run the experiment |
1069 |
|
|