New URL for NEMO forge!   http://forge.nemo-ocean.eu

Since March 2022 along with NEMO 4.2 release, the code development moved to a self-hosted GitLab.
This present forge is now archived and remained online for history.
WAD_doc.tex in branches/2017/dev_CNRS_2017/NEMOGCM/CONFIG/TEST_CASES/WAD/MY_DOCS – NEMO

source: branches/2017/dev_CNRS_2017/NEMOGCM/CONFIG/TEST_CASES/WAD/MY_DOCS/WAD_doc.tex @ 8882

Last change on this file since 8882 was 7610, checked in by acc, 7 years ago

Branch 2016/dev_merge_2016. Minor correction to WAD documentation and add in WAD_TEST_CASES/MY_SRC/bdyini.F90 which removes an apparently unnecessary restriction (to be checked) that would otherwise stop test case 7

  • Property svn:executable set to *
File size: 23.2 KB
Line 
1\include{Preamble}
2
3\begin{document}
4
5\title{Draft description of NEMO wetting and drying scheme:     22 November 2016 }
6
7\author{ Hedong Liu, Jason Holt, Andrew Coward  and Michael J. Bell  }
8
9%------------------------------------------------------------------------
10% End of temporary latex header (to be removed)
11%------------------------------------------------------------------------
12
13% ================================================================
14% Chapter Ocean Dynamics (DYN)
15% ================================================================
16\chapter{Ocean Dynamics (DYN)}
17\label{DYN}
18\minitoc
19
20% add a figure for  dynvor ens, ene latices
21
22$\ $\newline    % force a new ligne
23
24% ================================================================
25% Wetting and drying
26% ================================================================
27\section{Wetting and drying }
28\label{DYN_wetdry}
29
30This is preliminary documentation for the wetting and drying code (WAD).  The emphasis is
31on explaining the rationale for the code.  The approach used by the WAD is similar to that
32developed for POM by \cite{Oey06} and that developed for ROMS by \cite{WarnerEtal13} but
33the WAD uses schemes that have not been published.
34
35The following terminology is used. The depth of the topography (positive downwards)
36at each $(i,j)$ point is the quantity stored in array $\mathrm{ht\_wd}$ in the NEMO code.
37The height of the free surface (positive upwards) will be denoted by $ \mathrm{ssh}$. Both
38quantities are measured relative to a reference sea level at z$=$0m. Given the sign
39conventions used, the water depth is the height of the free surface plus the depth of the
40topography (i.e. $\mathrm{ssh} + \mathrm{ht\_wd}$).
41
42\namdisplay{nam_wad}
43
44WAD is activated by setting $\mathrm{ln\_wd} = \mathrm{.true.}$. Currently, this option
45works with six test cases provided in the WAD\_TEST\_CASES configuration. These are all
46pure sigma coordinate configurations which define their domain, surface forcing and
47initial conditions via a set of 'usrdef' routines in MY\_SRC. Extending this option to
48more realistic domains will require the derivation and provision of a suitable
49$\mathrm{ht\_wd}$ field in addition to the normal information provided in the domcfg.nc
50file. The six test cases are described in section \S\ref{WAD_test_cases}.
51
52The WAD takes all points in the domain below a land elevation of $\mathrm{rn\_wdld}$ to be
53covered by water. Points where the water depth is less than $\mathrm{rn\_wdmin1}$ are to
54be interpreted as ``dry''. The WAD requires the topography specified with a model
55configuration to have negative depths at points where the land is higher than the
56topography's reference sea-level. The vertical grid in NEMO is computed relative to an
57initial state with zero sea surface height elevation. These reference metrics and depths
58(i.e. the $\mathrm{e3t\_0, ht\_0}$ etc. arrays) are unaltered by WAD.
59$\mathrm{rn\_wdmin1}$ is usually chosen to be of order $0.075$m but complex topographies
60with steep slopes may require larger values. The scheme also makes use of a second
61parameter, $\mathrm{rn\_wdmin2}$, which is intended to be much smaller than
62$\mathrm{rn\_wdmin1}$, of order $10^{-6}$m or smaller {\it (Q: What is the purpose of
63$\mathrm{rn\_wdmin2}$? Seems a non-zero value is required for the flux limiter iterations
64to converge)}.
65
66The WAD modifies the fluxes across the faces of cells that are either already ``dry''
67or may become dry within the next time-step using an iterative method.  The
68first sub-section below describes this scheme. It also briefly describes the simpler ROMS
69method that has not been implemented.
70
71The following sub-section describes how the surface pressure gradients are modified by the
72WAD. The next sub-section should describe how the WAD maintains consistency between the
73points that are ``wet'' on the barotropic sub-steps and those that are wet on the longer
74baroclinic time-step. This sub-section has not yet been written. The final sub-section
75should describe the test cases that have been used to assess the performance of the WAD.
76
77%-----------------------------------------------------------------------------------------
78%   Flux limiters
79%-----------------------------------------------------------------------------------------
80\subsection   [Flux limiters (\textit{wet\_dry})]
81         {Flux limiters (\mdl{wet\_dry})}
82\label{DYN_wd_flux_limit}
83
84The flux limiter for the barotropic flow devised by Hedong Liu can be understood as follows:
85
86The continuity equation for the total water depth in a column
87\begin{equation} \label{dyn_wd_continuity}
88 \frac{\partial h}{\partial t} + \mathbf{\nabla.}(h\mathbf{u}) = 0 .
89\end{equation} 
90can be written in discrete form  as 
91
92\begin{align} \label{dyn_wd_continuity_2}
93\frac{e_1 e_2}{\Delta t} ( h_{i,j}(t_{n+1}) - h_{i,j}(t_e) )
94&= - ( \mathrm{flxu}_{i+1,j} - \mathrm{flxu}_{i,j}  + \mathrm{flxv}_{i,j+1} - \mathrm{flxv}_{i,j} ) \\
95&= \mathrm{zzflx}_{i,j} .
96\end{align} 
97
98In the above $h$ is the depth of the water in the column at point $(i,j)$,
99$\mathrm{flxu}_{i+1,j}$ is the flux out of the ``eastern'' face of the cell and
100$\mathrm{flxv}_{i,j+1}$ the flux out of the ``northern'' face of the cell; $t_{n+1}$ is
101the new timestep, $t_e$ is the old timestep (either $t_b$ or $t_n$) and $ \Delta t =
102t_{n+1} - t_e$; $e_1 e_2$ is the area of the tracer cells centred at $(i,j)$ and
103$\mathrm{zzflx}$ is the sum of the fluxes through all the faces.
104
105The flux limiter splits the flux $\mathrm{zzflx}$ into fluxes that are out of the cell
106(zzflxp) and fluxes that are into the cell (zzflxn).  Clearly
107
108\begin{equation} \label{dyn_wd_zzflx_p_n_1}
109\mathrm{zzflx}_{i,j} = \mathrm{zzflxp}_{i,j} + \mathrm{zzflxn}_{i,j} . 
110\end{equation} 
111
112The flux limiter iteratively adjusts the fluxes $\mathrm{flxu}$ and $\mathrm{flxv}$ until
113none of the cells will ``dry out''. To be precise the fluxes are limited until none of the
114cells has water depth less than $\mathrm{rn\_wdmin1}$ on step $n+1$.
115
116Let the fluxes on the $m$th iteration step be denoted by $\mathrm{flxu}^{(m)}$ and
117$\mathrm{flxv}^{(m)}$.  Then the adjustment is achieved by seeking a set of coefficients,
118$\mathrm{zcoef}_{i,j}^{(m)}$ such that:
119
120\begin{equation} \label{dyn_wd_continuity_coef}
121\begin{split}
122\mathrm{zzflxp}^{(m)}_{i,j} =& \mathrm{zcoef}_{i,j}^{(m)} \mathrm{zzflxp}^{(0)}_{i,j} \\
123\mathrm{zzflxn}^{(m)}_{i,j} =& \mathrm{zcoef}_{i,j}^{(m)} \mathrm{zzflxn}^{(0)}_{i,j}
124\end{split}
125\end{equation} 
126 
127where the coefficients are $1.0$ generally but can vary between $0.0$ and $1.0$ around
128cells that would otherwise dry.
129
130The iteration is initialised by setting
131
132\begin{equation} \label{dyn_wd_zzflx_initial}
133\mathrm{zzflxp^{(0)}}_{i,j} = \mathrm{zzflxp}_{i,j} , \quad  \mathrm{zzflxn^{(0)}}_{i,j} = \mathrm{zzflxn}_{i,j} .
134\end{equation} 
135
136The fluxes out of cell $(i,j)$ are updated at the $m+1$th iteration if the depth of the
137cell on timestep $t_e$, namely $h_{i,j}(t_e)$, is less than the total flux out of the cell
138times the timestep divided by the cell area. Using (\ref{dyn_wd_continuity_2}) this
139condition is
140
141\begin{equation} \label{dyn_wd_continuity_if}
142h_{i,j}(t_e)  - \mathrm{rn\_wdmin1} <  \frac{\Delta t}{e_1 e_2} ( \mathrm{zzflxp}^{(m)}_{i,j} + \mathrm{zzflxn}^{(m)}_{i,j} ) .
143\end{equation} 
144
145Rearranging (\ref{dyn_wd_continuity_if}) we can obtain an expression for the maximum
146outward flux that can be allowed and still maintain the minimum wet depth:
147
148\begin{equation} \label{dyn_wd_max_flux}
149\begin{split}
150\mathrm{zzflxp}^{(m+1)}_{i,j} = \Big[ (h_{i,j}(t_e) & - \mathrm{rn\_wdmin1} - \mathrm{rn\_wdmin2})  \frac{e_1 e_2}{\Delta t} \phantom{]} \\
151\phantom{[} & -  \mathrm{zzflxn}^{(m)}_{i,j} \Big]
152\end{split}
153\end{equation}
154
155Note a small tolerance ($\mathrm{rn\_wdmin2}$) has been introduced here {\it [Q: Why is
156this necessary/desirable?]}. Substituting from (\ref{dyn_wd_continuity_coef}) gives an
157expression for the coefficient needed to multiply the outward flux at this cell in order
158to avoid drying.
159
160\begin{equation} \label{dyn_wd_continuity_nxtcoef}
161\begin{split}
162\mathrm{zcoef}^{(m+1)}_{i,j} = \Big[ (h_{i,j}(t_e) & - \mathrm{rn\_wdmin1} - \mathrm{rn\_wdmin2})  \frac{e_1 e_2}{\Delta t} \phantom{]} \\
163\phantom{[} & -  \mathrm{zzflxn}^{(m)}_{i,j} \Big] \frac{1}{ \mathrm{zzflxp}^{(0)}_{i,j} } 
164\end{split}
165\end{equation} 
166
167Only the outward flux components are altered but, of course, outward fluxes from one cell
168are inward fluxes to adjacent cells and the balance in these cells may need subsequent
169adjustment; hence the iterative nature of this scheme.  Note, for example, that the flux
170across the ``eastern'' face of the $(i,j)$th cell is only updated at the $m+1$th iteration
171if that flux at the $m$th iteration is out of the $(i,j)$th cell. If that is the case then
172the flux across that face is into the $(i+1,j)$ cell and that flux will not be updated by
173the calculation for the $(i+1,j)$th cell. In this sense the updates to the fluxes across
174the faces of the cells do not ``compete'' (they do not over-write each other) and one
175would expect the scheme to converge relatively quickly. The scheme is also flux based so
176conserves mass.
177
178The ROMS scheme to prevent drying out of a cell is somewhat simpler. It specifies that if
179a tracer cell is dry (the water depth is less than $\mathrm{rn\_wdmin1}$) on the backward
180timestep, $t_e$, then any outward flux through its cell faces should be set to zero. This
181scheme has a clear physical rationale. This scheme is equivalent to setting
182$\mathrm{zcoef}^{(m+1)}_{i,j}$ to $0.0$ whenever a cell is at risk of drying.  One
183objection to the ROMS scheme is that it introduces a spurious step function in the flux
184out of a cell as the water depth in the cell passes through the ``critical'' value
185$\mathrm{rn\_wdmin1}$.
186
187%----------------------------------------------------------------------------------------
188%      Surface pressure gradients
189%----------------------------------------------------------------------------------------
190\subsection   [Modification of surface pressure gradients (\textit{dynhpg})]
191         {Modification of surface pressure gradients (\mdl{dynhpg})}
192\label{DYN_wd_spg}
193
194At ``dry'' points the water depth is usually close to $\mathrm{rn\_wdmin1}$. If the
195topography is sloping at these points the sea-surface will have a similar slope and there
196will hence be very large horizontal pressure gradients at these points. The WAD modifies
197the magnitude but not the sign of the surface pressure gradients (zhpi and zhpj) at such
198points by mulitplying them by positive factors (zcpx and zcpy respectively) that lie
199between $0$ and $1$.
200
201We describe how the scheme works for the ``eastward'' pressure gradient, zhpi, calculated
202at the $(i,j)$th $u$-point. The scheme uses the ht\_wd depths and surface heights at the
203neighbouring $(i+1,j)$ and $(i,j)$ tracer points.  zcpx is calculated using two logicals
204variables, $\mathrm{ll\_tmp1}$ and $\mathrm{ll\_tmp2}$ which are evaluated for each grid
205column.  The three possible combinations are illustrated in figure \ref{Fig_WAD_dynhpg}.
206%>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
207\begin{figure}[!ht] \begin{center}
208\includegraphics[width=0.8\textwidth]{Fig_WAD_dynhpg}
209\caption{ \label{Fig_WAD_dynhpg}
210Illustrations of the three possible combinations of the logical variables controlling the
211limiting of the horizontal pressure gradient in wetting and drying regimes}
212\end{center}\end{figure}
213%>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
214
215The first logical, $\mathrm{ll\_tmp1}$, is set to true if and only if the water depth at
216both neighbouring points is greater than $\mathrm{rn\_wdmin1} + \mathrm{rn\_wdmin2}$ and
217the minimum height of the sea surface at the two points is greater than the maximum height
218of the topography at the two points:
219
220\begin{equation} \label{dyn_ll_tmp1}
221\begin{split}
222\mathrm{ll\_tmp1}  = & \mathrm{MIN(sshn(ji,jj), sshn(ji+1,jj))} > \\
223                     & \quad \mathrm{MAX(-ht\_wd(ji,jj), -ht\_wd(ji+1,jj))\  .and.} \\
224& \mathrm{MAX(sshn(ji,jj) + ht\_wd(ji,jj),} \\
225& \mathrm{\phantom{MAX(}sshn(ji+1,jj) + ht\_wd(ji+1,jj))} >\\
226& \quad\quad\mathrm{rn\_wdmin1 + rn\_wdmin2 }
227\end{split}
228\end{equation} 
229
230The second logical, $\mathrm{ll\_tmp2}$, is set to true if and only if the maximum height
231of the sea surface at the two points is greater than the maximum height of the topography
232at the two points plus $\mathrm{rn\_wdmin1} + \mathrm{rn\_wdmin2}$
233
234\begin{equation} \label{dyn_ll_tmp2}
235\begin{split}
236\mathrm{ ll\_tmp2 } = & \mathrm{( ABS( sshn(ji,jj) - sshn(ji+1,jj) ) > 1.E-12 )\ .AND.}\\
237& \mathrm{( MAX(sshn(ji,jj), sshn(ji+1,jj)) > } \\
238& \mathrm{\phantom{(} MAX(-ht\_wd(ji,jj), -ht\_wd(ji+1,jj)) + rn\_wdmin1 + rn\_wdmin2}) .
239\end{split}
240\end{equation} 
241
242If $\mathrm{ll\_tmp1}$ is true then the surface pressure gradient, zhpi at the $(i,j)$
243point is unmodified. If both logicals are false zhpi is set to zero.
244
245If $\mathrm{ll\_tmp1}$ is true and $\mathrm{ll\_tmp2}$ is false then the surface pressure
246gradient is multiplied through by zcpx which is the absolute value of the difference in
247the water depths at the two points divided by the difference in the surface heights at the
248two points. Thus the sign of the sea surface height gradient is retained but the magnitude
249of the pressure force is determined by the difference in water depths rather than the
250difference in surface height between the two points. Note that dividing by the difference
251between the sea surface heights can be problematic if the heights approach parity. An
252additional condition is applied to $\mathrm{ ll\_tmp2 }$ to ensure it is .false. in such
253conditions.
254
255%----------------------------------------------------------------------------------------
256%      The WAD test cases
257%----------------------------------------------------------------------------------------
258\subsection   [The WAD test cases (\textit{usrdef\_zgr})]
259         {The WAD test cases (\mdl{usrdef\_zgr})}
260\label{WAD_test_cases}
261
262This section contains details of the seven test cases that can be run as part of the
263WAD\_TEST\_CASES configuration. All the test cases are shallow (less than 10m deep),
264basins or channels with 4m high walls and some of topography that can wet and dry up to
2652.5m above sea-level. The horizontal grid is uniform with a 1km resolution and measures
26652km by 34km. These dimensions are determined by a combination of code in the
267\mdl{usrdef\_nam} module located in the WAD\_TEST\_CASES/MY\_SRC directory and setting
268read in from the namusr\_def namelist. The first six test cases are closed systems with no
269rotation or external forcing and motion is simply initiated by an initial ssh slope. The
270seventh test case introduces and open boundary at the right-hand end of the channel which
271is forced with sinousoidally varying ssh and barotropic velocities.
272
273\namdisplay{nam_wad_usr}
274
275The $\mathrm{nn\_wad\_test}$ parameter can takes values 1 to 7 and it is this parameter
276that determines which of the test cases will be run. Most cases can be run with the
277default settings but the simple linear slope cases (tests 1 and 5) can be run with lower
278values of $\mathrm{rn\_wdmin1}$. Any recommended changes to the default namelist settings
279will be stated in the individual subsections.
280
281Test case 7 requires additional {\tt namelist\_cfg} changes to activate the open boundary
282and lengthen the duration of the run (in order to demonstrate the full forcing cycle).
283There is also a simple python script which needs to be run in order to generate the
284boundary forcing files.  Full details are given in subsection (\ref{WAD_test_case7}).
285
286\clearpage
287\subsubsection [WAD test case 1 : A simple linear slope]
288                    {WAD test case 1 : A simple linear slope}
289\label{WAD_test_case1}
290
291The first test case is a simple linear slope (in the x-direction, uniform in y) with an
292adverse SSH gradient that, when released, creates a surge up the slope. The parameters are
293chosen such that the surge rises above sea-level before falling back and oscillating
294towards an equilibrium position. This case can be run with $\mathrm{rn\_wdmin1}$ values as
295low as 0.075m. I.e. the following change may be made to the default values in {\tt
296namelist\_cfg} (for this test only):
297
298\namdisplay{nam_wad_tc1}
299
300%>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
301\begin{figure}[htb] \begin{center}
302\includegraphics[width=0.8\textwidth]{Fig_WAD_TC1}
303\caption{ \label{Fig_WAD_TC1}
304The evolution of the sea surface height in WAD\_TEST\_CASE 1 from the initial state (t=0)
305over the first three hours of simulation. Note that in this time-frame the resultant surge
306reaches to nearly 2m above sea-level before retreating.}
307\end{center}\end{figure}
308%>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
309
310\clearpage
311\subsubsection [WAD test case 2 : A parabolic channel ]
312                    {WAD test case 2 : A parabolic channel}
313\label{WAD_test_case2}
314
315The second and third test cases use a closed channel which is parabolic in x and uniform
316in y.  Test case 2 uses a gentler initial SSH slope which nevertheless demonstrates the
317ability to wet and dry on both sides of the channel. This solution requires values of
318$\mathrm{rn\_wdmin1}$ at least 0.3m ({\it Q.: A function of the maximum topographic
319slope?})
320
321\namdisplay{nam_wad_tc2}
322
323%>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
324\begin{figure}[htb] \begin{center}
325\includegraphics[width=0.8\textwidth]{Fig_WAD_TC2}
326\caption{ \label{Fig_WAD_TC2}
327The evolution of the sea surface height in WAD\_TEST\_CASE 2 from the initial state (t=0)
328over the first three hours of simulation. Note that in this time-frame the resultant sloshing
329causes wetting and drying on both sides of the parabolic channel.}
330\end{center}\end{figure}
331%>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
332
333\clearpage
334\subsubsection [WAD test case 3 : A parabolic channel (extreme slope) ]
335                    {WAD test case 3 : A parabolic channel (extreme slope)}
336\label{WAD_test_case3}
337
338Similar to test case 2 but with a steeper initial SSH slope. The solution is similar but more vigorous.
339
340\namdisplay{nam_wad_tc3}
341
342%>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
343\begin{figure}[htb] \begin{center}
344\includegraphics[width=0.8\textwidth]{Fig_WAD_TC3}
345\caption{ \label{Fig_WAD_TC3}
346The evolution of the sea surface height in WAD\_TEST\_CASE 3 from the initial state (t=0)
347over the first three hours of simulation. Note that in this time-frame the resultant sloshing
348causes wetting and drying on both sides of the parabolic channel.}
349\end{center}\end{figure}
350%>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
351
352\clearpage
353\subsubsection [WAD test case 4 : A parabolic bowl ]
354                    {WAD test case 4 : A parabolic bowl}
355\label{WAD_test_case4}
356
357Test case 4 includes variation in the y-direction in the form of a parabolic bowl. The
358initial condition is now a raised bulge centred over the bowl. Figure \ref{Fig_WAD_TC4}
359shows a cross-section of the SSH in the X-direction but features can be seen to propagate
360in all directions and interfere when return paths cross.
361
362\namdisplay{nam_wad_tc4}
363
364%>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
365\begin{figure}[htb] \begin{center}
366\includegraphics[width=0.8\textwidth]{Fig_WAD_TC4}
367\caption{ \label{Fig_WAD_TC4}
368The evolution of the sea surface height in WAD\_TEST\_CASE 4 from the initial state (t=0)
369over the first three hours of simulation. Note that this test case is a parabolic bowl with
370variations occurring in the y-direction too (not shown here).}
371\end{center}\end{figure}
372%>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
373
374\clearpage
375\subsubsection [WAD test case 5 : A double slope with shelf channel ]
376                    {WAD test case 5 : A double slope with shelf channel}
377\label{WAD_test_case5}
378
379Similar in nature to test case 1 but with a change in slope and a mid-depth shelf.
380
381\namdisplay{nam_wad_tc5}
382
383%>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
384\begin{figure}[htb] \begin{center}
385\includegraphics[width=0.8\textwidth]{Fig_WAD_TC5}
386\caption{ \label{Fig_WAD_TC5}
387The evolution of the sea surface height in WAD\_TEST\_CASE 5 from the initial state (t=0)
388over the first three hours of simulation. The surge resulting in this case wets to the full
389depth permitted (2.5m above sea-level) and is only halted by the 4m high side walls.}
390\end{center}\end{figure}
391%>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
392
393\clearpage
394\subsubsection [WAD test case 6 : A parabolic channel with central bar ]
395                    {WAD test case 6 : A parabolic channel with central bar}
396\label{WAD_test_case6}
397
398Test cases 1 to 5 have all used uniform T and S conditions. The dashed line in each plot
399shows the surface salinity along the y=17 line which remains satisfactorily constant. Test
400case 6 introduces variation in salinity by taking a parabolic channel divided by a central
401bar (gaussian) and using two different salinity values in each half of the channel. This
402step change in salinity is initially enforced by the central bar but the bar is
403subsequently over-topped after the initial SSH gradient is released. The time series in
404this case shows the SSH evolution with the water coloured according to local salinity
405values. Encroachment of the high salinity (red) waters into the low salinity (blue) basin
406can clearly be seen.
407
408\namdisplay{nam_wad_tc6}
409
410%>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
411\begin{figure}[htb] \begin{center}
412\includegraphics[width=0.8\textwidth]{Fig_WAD_TC6}
413\caption{ \label{Fig_WAD_TC6}
414The evolution of the sea surface height in WAD\_TEST\_CASE 6 from the initial state (t=0)
415over the first three hours of simulation. Water is coloured according to local salinity
416values. Encroachment of the high salinity (red) waters into the low salinity (blue) basin
417can clearly be seen although the largest influx occurs early in the sequence between the
418frames shown.}
419\end{center}\end{figure}
420%>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
421
422\clearpage
423\subsubsection [WAD test case 7 : A double slope with shelf, open-ended channel ]
424                    {WAD test case 7 : A double slope with shelf, open-ended channel}
425\label{WAD_test_case7}
426
427Similar in nature to test case 5 but with an open boundary forced with a sinusoidally
428varying ssh. This test case has been introduced to emulate a typical coastal application
429with a tidally forced open boundary. The bathymetry and setup is identical to test case 5
430except the right hand end of the channel is now open and has simple ssh and barotropic
431velocity boundary conditions applied at the open boundary. Several additional steps and
432namelist changes are required to run this test.
433
434\namdisplay{nam_wad_tc7}
435
436In addition, the boundary condition files must be generated using the python script
437provided.
438
439\begin{verbatim}
440python ./makebdy_tc7.py
441\end{verbatim}
442
443will create the following boundary files for this test (assuming a suitably configured
444python environment: python2.7 with netCDF4 and numpy):
445
446\begin{verbatim}
447  bdyssh_tc7_m12d30.nc   bdyuv_tc7_m12d30.nc
448  bdyssh_tc7_m01d01.nc   bdyuv_tc7_m01d01.nc
449  bdyssh_tc7_m01d02.nc   bdyuv_tc7_m01d02.nc
450  bdyssh_tc7_m01d03.nc   bdyuv_tc7_m01d03.nc
451\end{verbatim}
452
453These are sufficient for up to a three day simulation; the script is easily adapted if
454longer periods are required.
455
456%>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
457\begin{sidewaysfigure}[htb] \begin{center}
458\includegraphics[width=0.8\textwidth]{Fig_WAD_TC7}
459\caption{ \label{Fig_WAD_TC7}
460The evolution of the sea surface height in WAD\_TEST\_CASE 7 from the initial state (t=0)
461over the first 24 hours of simulation. After the initial surge the solution settles into a
462simulated tidal cycle with an amplitude of 5m. This is enough to repeatedly wet and dry
463both shelves.}
464
465\end{center}\end{sidewaysfigure}
466%>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
467
468
469% ================================================================
470
471\bibliographystyle{wileyqj}
472\bibliography{references}
473
474\end{document}
Note: See TracBrowser for help on using the repository browser.