| 180 |
\section{Example experiments} |
\section{Example experiments} |
| 181 |
\label{sect:modelExamples} |
\label{sect:modelExamples} |
| 182 |
|
|
| 183 |
Now that you have successfully downloaded the model code we recommend that |
The MITgcm distribution comes with a set of twenty-four pre-configured |
| 184 |
you first try to run the examples provided with the base version. You will |
numerical experiments. Some of these examples experiments are tests of |
| 185 |
probably want to run the example that is the closest to the configuration |
individual parts of the model code, but many are fully fledged numerical |
| 186 |
you will use eventually. The examples are located in subdirectories under |
simulations. A few of the examples are used for tutorial documentation |
| 187 |
the directory \textit{verification} and are briefly described below (a full |
in sections \ref{sec:eg-baro} - \ref{sec:eg-global}. The other examples |
| 188 |
description is given in section 2): |
follow the same general structure as the tutorial examples. However, |
| 189 |
|
they only include brief instructions in a text file called {\it README}. |
| 190 |
|
The examples are located in subdirectories under |
| 191 |
|
the directory \textit{verification}. Each |
| 192 |
|
example is briefly described below. |
| 193 |
|
|
| 194 |
\subsection{List of model examples} |
\subsection{Full list of model examples} |
| 195 |
|
|
| 196 |
\begin{itemize} |
\begin{enumerate} |
| 197 |
\item \textit{exp0} - single layer, ocean double gyre (barotropic with |
\item \textit{exp0} - single layer, ocean double gyre (barotropic with |
| 198 |
free-surface). |
free-surface). This experiment is described in detail in section |
| 199 |
|
\ref{sec:eg-baro}. |
| 200 |
|
|
| 201 |
\item \textit{exp1} - 4 layers, ocean double gyre. |
\item \textit{exp1} - Four layer, ocean double gyre. This experiment is described in detail in section |
| 202 |
|
\ref{sec:eg-baroc}. |
| 203 |
|
|
| 204 |
\item \textit{exp2} - 4x4 degree global ocean simulation with steady |
\item \textit{exp2} - 4x4 degree global ocean simulation with steady |
| 205 |
climatological forcing. |
climatological forcing. This experiment is described in detail in section |
| 206 |
|
\ref{sec:eg-global}. |
| 207 |
|
|
| 208 |
\item \textit{exp4} - flow over a Gaussian bump in open-water or channel |
\item \textit{exp4} - Flow over a Gaussian bump in open-water or channel |
| 209 |
with open boundaries. |
with open boundaries. |
| 210 |
|
|
| 211 |
\item \textit{exp5} - inhomogenously forced ocean convection in a doubly |
\item \textit{exp5} - Inhomogenously forced ocean convection in a doubly |
| 212 |
periodic box. |
periodic box. |
| 213 |
|
|
| 214 |
\item \textit{front\_relax} - relaxation of an ocean thermal front (test for |
\item \textit{front\_relax} - Relaxation of an ocean thermal front (test for |
| 215 |
Gent/McWilliams scheme). 2D (Y-Z). |
Gent/McWilliams scheme). 2D (Y-Z). |
| 216 |
|
|
| 217 |
\item \textit{internal wave} - ocean internal wave forced by open boundary |
\item \textit{internal wave} - Ocean internal wave forced by open boundary |
| 218 |
conditions. |
conditions. |
| 219 |
|
|
| 220 |
\item \textit{natl\_box} - eastern subtropical North Atlantic with KPP |
\item \textit{natl\_box} - Eastern subtropical North Atlantic with KPP |
| 221 |
scheme; 1 month integration |
scheme; 1 month integration |
| 222 |
|
|
| 223 |
\item \textit{hs94.1x64x5} - zonal averaged atmosphere using Held and Suarez |
\item \textit{hs94.1x64x5} - Zonal averaged atmosphere using Held and Suarez |
| 224 |
'94 forcing. |
'94 forcing. |
| 225 |
|
|
| 226 |
\item \textit{hs94.128x64x5} - 3D atmosphere dynamics using Held and Suarez |
\item \textit{hs94.128x64x5} - 3D atmosphere dynamics using Held and Suarez |
| 229 |
\item \textit{hs94.cs-32x32x5} - 3D atmosphere dynamics using Held and |
\item \textit{hs94.cs-32x32x5} - 3D atmosphere dynamics using Held and |
| 230 |
Suarez '94 forcing on the cubed sphere. |
Suarez '94 forcing on the cubed sphere. |
| 231 |
|
|
| 232 |
\item \textit{aim.5l\_zon-ave} - Intermediate Atmospheric physics, 5 layers |
\item \textit{aim.5l\_zon-ave} - Intermediate Atmospheric physics. Global |
| 233 |
Molteni physics package. Global Zonal Mean configuration, 1x64x5 resolution. |
Zonal Mean configuration, 1x64x5 resolution. |
| 234 |
|
|
| 235 |
\item \textit{aim.5l\_XZ\_Equatorial\_Slice} - Intermediate Atmospheric |
\item \textit{aim.5l\_XZ\_Equatorial\_Slice} - Intermediate Atmospheric |
| 236 |
physics, 5 layers Molteni physics package. Equatorial Slice configuration. |
physics, equatorial Slice configuration. |
| 237 |
2D (X-Z). |
2D (X-Z). |
| 238 |
|
|
| 239 |
\item \textit{aim.5l\_Equatorial\_Channel} - Intermediate Atmospheric |
\item \textit{aim.5l\_Equatorial\_Channel} - Intermediate Atmospheric |
| 240 |
physics, 5 layers Molteni physics package. 3D Equatorial Channel |
physics. 3D Equatorial Channel configuration. |
|
configuration (not completely tested). |
|
| 241 |
|
|
| 242 |
\item \textit{aim.5l\_LatLon} - Intermediate Atmospheric physics, 5 layers |
\item \textit{aim.5l\_LatLon} - Intermediate Atmospheric physics. |
| 243 |
Molteni physics package. Global configuration, 128x64x5 resolution. |
Global configuration, on latitude longitude grid with 128x64x5 grid points |
| 244 |
|
($2.8^\circ{\rm degree}$ resolution). |
| 245 |
|
|
| 246 |
\item \textit{adjustment.128x64x1} |
\item \textit{adjustment.128x64x1} Barotropic adjustment |
| 247 |
|
problem on latitude longitude grid with 128x64 grid points ($2.8^\circ{\rm degree}$ resolution). |
| 248 |
|
|
| 249 |
\item \textit{adjustment.cs-32x32x1} |
\item \textit{adjustment.cs-32x32x1} |
| 250 |
\end{itemize} |
Barotropic adjustment |
| 251 |
|
problem on cube sphere grid with 32x32 points per face ( roughly |
| 252 |
|
$2.8^\circ{\rm degree}$ resolution). |
| 253 |
|
|
| 254 |
|
\item \textit{advect\_cs} Two-dimensional passive advection test on |
| 255 |
|
cube sphere grid. |
| 256 |
|
|
| 257 |
|
\item \textit{advect\_xy} Two-dimensional (horizontal plane) passive advection |
| 258 |
|
test on cartesian grid. |
| 259 |
|
|
| 260 |
|
\item \textit{advect\_yz} Two-dimensional (vertical plane) passive advection test on cartesian grid. |
| 261 |
|
|
| 262 |
|
\item \textit{carbon} Simple passive tracer experiment. Includes derivative |
| 263 |
|
calculation. Described in detail in section \ref{sec:eg-carbon-ad}. |
| 264 |
|
|
| 265 |
|
\item \textit{flt\_example} Example of using float package. |
| 266 |
|
|
| 267 |
|
\item \textit{global\_ocean.90x40x15} Global circulation with |
| 268 |
|
GM, flux boundary conditions and poles. |
| 269 |
|
|
| 270 |
|
\item \textit{solid-body.cs-32x32x1} Solid body rotation test for cube sphere |
| 271 |
|
grid. |
| 272 |
|
|
| 273 |
|
\end{enumerate} |
| 274 |
|
|
| 275 |
\subsection{Directory structure of model examples} |
\subsection{Directory structure of model examples} |
| 276 |
|
|