| 1 |
\section{Surface Driven Convection} |
\section{Surface Driven Convection} |
| 2 |
|
\label{www:tutorials} |
| 3 |
\label{sect:eg-bconv} |
\label{sect:eg-bconv} |
| 4 |
|
|
| 5 |
\bodytext{bgcolor="#FFFFFFFF"} |
\bodytext{bgcolor="#FFFFFFFF"} |
| 40 |
\end{itemize} |
\end{itemize} |
| 41 |
|
|
| 42 |
\subsection{Overview} |
\subsection{Overview} |
| 43 |
|
\label{www:tutorials} |
| 44 |
|
|
| 45 |
The model domain consists of an approximately 3 |
The model domain consists of an approximately 3 |
| 46 |
km square by 1 km deep box of initially |
km square by 1 km deep box of initially |
| 110 |
in a binary data file generated using the Matlab script {\it input/gendata.m}. |
in a binary data file generated using the Matlab script {\it input/gendata.m}. |
| 111 |
|
|
| 112 |
\subsection{Equations solved} |
\subsection{Equations solved} |
| 113 |
|
\label{www:tutorials} |
| 114 |
|
|
| 115 |
The model is configured in nonhydrostatic form, that is, all terms in the Navier |
The model is configured in nonhydrostatic form, that is, all terms in the Navier |
| 116 |
Stokes equations are retained and the pressure field is found, subject to appropriate |
Stokes equations are retained and the pressure field is found, subject to appropriate |
| 180 |
\\ |
\\ |
| 181 |
|
|
| 182 |
\subsection{Discrete numerical configuration} |
\subsection{Discrete numerical configuration} |
| 183 |
|
\label{www:tutorials} |
| 184 |
|
|
| 185 |
The domain is discretised with a uniform grid spacing in each direction. There are 64 |
The domain is discretised with a uniform grid spacing in each direction. There are 64 |
| 186 |
grid cells in directions $x$ and $y$ and 20 vertical levels thus the domain |
grid cells in directions $x$ and $y$ and 20 vertical levels thus the domain |
| 187 |
comprises a total of just over 80 000 gridpoints. |
comprises a total of just over 80 000 gridpoints. |
| 188 |
|
|
| 189 |
\subsection{Numerical stability criteria and other considerations} |
\subsection{Numerical stability criteria and other considerations} |
| 190 |
|
\label{www:tutorials} |
| 191 |
|
|
| 192 |
For a heat flux of 800 Wm$^2$ and a rotation rate of $10^{-4}$ s$^{-1}$ the |
For a heat flux of 800 Wm$^2$ and a rotation rate of $10^{-4}$ s$^{-1}$ the |
| 193 |
plume-scale can be expected to be a few hundred meters guiding our choice of grid |
plume-scale can be expected to be a few hundred meters guiding our choice of grid |
| 213 |
correlated over 50 m. |
correlated over 50 m. |
| 214 |
|
|
| 215 |
\subsection{Experiment configuration} |
\subsection{Experiment configuration} |
| 216 |
|
\label{www:tutorials} |
| 217 |
|
|
| 218 |
The model configuration for this experiment resides under the directory |
The model configuration for this experiment resides under the directory |
| 219 |
{\it verification/convection/}. The experiment files |
{\it verification/convection/}. The experiment files |
| 230 |
experiment. Below we describe these experiment-specific customisations. |
experiment. Below we describe these experiment-specific customisations. |
| 231 |
|
|
| 232 |
\subsubsection{File {\it code/CPP\_EEOPTIONS.h}} |
\subsubsection{File {\it code/CPP\_EEOPTIONS.h}} |
| 233 |
|
\label{www:tutorials} |
| 234 |
|
|
| 235 |
This file uses standard default values and does not contain |
This file uses standard default values and does not contain |
| 236 |
customisations for this experiment. |
customisations for this experiment. |
| 237 |
|
|
| 238 |
\subsubsection{File {\it code/CPP\_OPTIONS.h}} |
\subsubsection{File {\it code/CPP\_OPTIONS.h}} |
| 239 |
|
\label{www:tutorials} |
| 240 |
|
|
| 241 |
This file uses standard default values and does not contain |
This file uses standard default values and does not contain |
| 242 |
customisations for this experiment. |
customisations for this experiment. |
| 243 |
|
|
| 244 |
\subsubsection{File {\it code/SIZE.h}} |
\subsubsection{File {\it code/SIZE.h}} |
| 245 |
|
\label{www:tutorials} |
| 246 |
|
|
| 247 |
Three lines are customized in this file. These prescribe the domain grid dimensions. |
Three lines are customized in this file. These prescribe the domain grid dimensions. |
| 248 |
\begin{itemize} |
\begin{itemize} |
| 270 |
\begin{rawhtml}</PRE>\end{rawhtml} |
\begin{rawhtml}</PRE>\end{rawhtml} |
| 271 |
|
|
| 272 |
\subsubsection{File {\it input/data}} |
\subsubsection{File {\it input/data}} |
| 273 |
|
\label{www:tutorials} |
| 274 |
|
|
| 275 |
This file, reproduced completely below, specifies the main parameters |
This file, reproduced completely below, specifies the main parameters |
| 276 |
for the experiment. The parameters that are significant for this configuration |
for the experiment. The parameters that are significant for this configuration |
| 788 |
|
|
| 789 |
|
|
| 790 |
\subsubsection{File {\it input/data.pkg}} |
\subsubsection{File {\it input/data.pkg}} |
| 791 |
|
\label{www:tutorials} |
| 792 |
|
|
| 793 |
This file uses standard default values and does not contain |
This file uses standard default values and does not contain |
| 794 |
customisations for this experiment. |
customisations for this experiment. |
| 795 |
|
|
| 796 |
\subsubsection{File {\it input/eedata}} |
\subsubsection{File {\it input/eedata}} |
| 797 |
|
\label{www:tutorials} |
| 798 |
|
|
| 799 |
This file uses standard default values and does not contain |
This file uses standard default values and does not contain |
| 800 |
customisations for this experiment. |
customisations for this experiment. |
| 801 |
|
|
| 802 |
|
|
| 803 |
\subsubsection{File {\it input/Qsurf.bin}} |
\subsubsection{File {\it input/Qsurf.bin}} |
| 804 |
|
\label{www:tutorials} |
| 805 |
|
|
| 806 |
The file {\it input/Qsurf.bin} specifies a two-dimensional ($x,y$) |
The file {\it input/Qsurf.bin} specifies a two-dimensional ($x,y$) |
| 807 |
map of heat flux values where |
map of heat flux values where |
| 824 |
\end{figure} |
\end{figure} |
| 825 |
|
|
| 826 |
\subsection{Running the example} |
\subsection{Running the example} |
| 827 |
|
\label{www:tutorials} |
| 828 |
|
|
| 829 |
\subsubsection{Code download} |
\subsubsection{Code download} |
| 830 |
|
\label{www:tutorials} |
| 831 |
|
|
| 832 |
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. |
| 833 |
Instructions for downloading the code can be found in \ref{sect:obtainingCode}. |
Instructions for downloading the code can be found in \ref{sect:obtainingCode}. |
| 834 |
|
|
| 835 |
\subsubsection{Experiment Location} |
\subsubsection{Experiment Location} |
| 836 |
|
\label{www:tutorials} |
| 837 |
|
|
| 838 |
This example experiments is located under the release sub-directory |
This example experiments is located under the release sub-directory |
| 839 |
|
|
| 841 |
{\it verification/convection/ } |
{\it verification/convection/ } |
| 842 |
|
|
| 843 |
\subsubsection{Running the Experiment} |
\subsubsection{Running the Experiment} |
| 844 |
|
\label{www:tutorials} |
| 845 |
|
|
| 846 |
To run the experiment |
To run the experiment |
| 847 |
|
|