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