<p><b>mpetersen@lanl.gov</b> 2013-03-21 17:23:44 -0600 (Thu, 21 Mar 2013)</p><p>user's guide: add overflow test case section<br>
</p><hr noshade><pre><font color="gray">Added: trunk/documents/users_guide/ocean/figures/overflow_1km_0hr.pdf
===================================================================
(Binary files differ)

Index: trunk/documents/users_guide/ocean/figures/overflow_1km_0hr.pdf
===================================================================
--- trunk/documents/users_guide/ocean/figures/overflow_1km_0hr.pdf        2013-03-21 18:48:18 UTC (rev 2651)
+++ trunk/documents/users_guide/ocean/figures/overflow_1km_0hr.pdf        2013-03-21 23:23:44 UTC (rev 2652)

Property changes on: trunk/documents/users_guide/ocean/figures/overflow_1km_0hr.pdf
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+application/octet-stream
\ No newline at end of property
Added: trunk/documents/users_guide/ocean/figures/overflow_1km_3hr.pdf
===================================================================
(Binary files differ)

Index: trunk/documents/users_guide/ocean/figures/overflow_1km_3hr.pdf
===================================================================
--- trunk/documents/users_guide/ocean/figures/overflow_1km_3hr.pdf        2013-03-21 18:48:18 UTC (rev 2651)
+++ trunk/documents/users_guide/ocean/figures/overflow_1km_3hr.pdf        2013-03-21 23:23:44 UTC (rev 2652)

Property changes on: trunk/documents/users_guide/ocean/figures/overflow_1km_3hr.pdf
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+application/octet-stream
\ No newline at end of property
Added: trunk/documents/users_guide/ocean/figures/overflow_1km_9hr.pdf
===================================================================
(Binary files differ)

Index: trunk/documents/users_guide/ocean/figures/overflow_1km_9hr.pdf
===================================================================
--- trunk/documents/users_guide/ocean/figures/overflow_1km_9hr.pdf        2013-03-21 18:48:18 UTC (rev 2651)
+++ trunk/documents/users_guide/ocean/figures/overflow_1km_9hr.pdf        2013-03-21 23:23:44 UTC (rev 2652)

Property changes on: trunk/documents/users_guide/ocean/figures/overflow_1km_9hr.pdf
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+application/octet-stream
\ No newline at end of property
Modified: trunk/documents/users_guide/ocean/mpas_ocean.bib
===================================================================
--- trunk/documents/users_guide/ocean/mpas_ocean.bib        2013-03-21 18:48:18 UTC (rev 2651)
+++ trunk/documents/users_guide/ocean/mpas_ocean.bib        2013-03-21 23:23:44 UTC (rev 2652)
@@ -59,6 +59,14 @@
   adsnote = {Provided by the SAO/NASA Astrophysics Data System}
 }
 
+@book{Haidvogel_Beckmann99bk,
+author=&quot;D.B. Haidvogel and A. Beckmann&quot;,
+title=&quot;Numerical Ocean Circulation Modeling&quot;,
+year=1999,
+publisher=&quot;Imperial College Press&quot;,
+address=&quot;London&quot;}
+
+
 @ARTICLE{Legg_ea06om,
    author = {{Legg}, S. and {Hallberg}, R.~W. and {Girton}, J.~B.},
     title = &quot;{Comparison of entrainment in overflows simulated by z-coordinate, isopycnal and non-hydrostatic models}&quot;,

Modified: trunk/documents/users_guide/ocean/test_cases/overflow.tex
===================================================================
--- trunk/documents/users_guide/ocean/test_cases/overflow.tex        2013-03-21 18:48:18 UTC (rev 2651)
+++ trunk/documents/users_guide/ocean/test_cases/overflow.tex        2013-03-21 23:23:44 UTC (rev 2652)
@@ -1,7 +1,10 @@
 \section{Overflow}
 \label{sec:overflow_description}
-describe test case here
+The overflow test case is an idealized domain designed to investigate the impact of topography on spurious mixing, and is similar to those found in \citet{Haidvogel_Beckmann99bk} and \citet[section 4]{Ilicak_ea12om}.  The domain is on a Cartesian plane of regularly spaced hexagons in the horizonal.  It is effectively two-dimensional, with dynamics occuring in the y-z plane, while the x-direction is four cells wide and periodic.  
 
+This test case is useful for parameter studies to compare vertical mixing schemes, strength and types of horizontal mixing, partial bottom cells, and choice of vertical coordinate.  More advanced statistics, like the resting potential energy \citep{Ilicak_ea12om}, may be used to produce quantitative assessments of these comparisons.  The included test cases follow the parameters in \citet[section 4]{Ilicak_ea12om} and use zero explicit tracer mixing, Laplacian horizontal mixing of momentum with a viscosity of $10^3$ m$^2$/s, and constant vertical mixing of momentum with a viscosity of $10^{-4}$ m$^2$/s.  The equation of state is linear, and vertical coordinate is z-star \citep{Adcroft_Campin04om}.
+
+
 \subsection{Provided Files}
 \label{subsec:overflow_files}
 
@@ -28,4 +31,14 @@
 
 \subsection{Results}
 \label{subsecc:overflow_results}
-results here
+Initially, a cold, dense volume of water is released at the top of a sill.  Within the course of an 18-hour simulation the cold water descends the steep mount and continues northward along the bottom.  The Coriolis parameter is set to zero so that rotational effects do not occur.  The speed of descent, or equivalently the time to reach the bottom, is a simple way to measure the amount of mixing that occurs as the plug of water descends.  In the two cases included with this release, the cold front reaches the bottom of the sill after eight hours for the high resolution case (1 km horizontal mesh, 100 layers), but after 16 hours for the low resolution case (10 km horizontal mesh, 40 layers).  Visualizations show that some ten-degree water remains after nine hours for the high-resolution case (Figure \ref{fig:overflow}), but has all mixed out for the low-resolution case (not shown).
+
+
+\begin{figure}[H!]
+        \label{fig:overflow}
+        \centering
+\includegraphics[scale=1.0]{ocean/figures/overflow_1km_0hr.pdf}\\
+\includegraphics[scale=1.0]{ocean/figures/overflow_1km_3hr.pdf}\\
+\includegraphics[scale=1.0]{ocean/figures/overflow_1km_9hr.pdf}
+\caption{Overflow test case results, showing vertical cross-sections of temperature (left) and kinetic energy (right).  Each horizontal axis is distance in km, and each vertical axis is layer index. Rows show initial condition (top), 6 hours (middle) and 9 hours (bottom). {\color{red}TBA: these images were made with matlab.  Next version will use python.}}
+\end{figure}

</font>
</pre>