<p><b>mpetersen@lanl.gov</b> 2013-03-07 10:55:03 -0700 (Thu, 07 Mar 2013)</p><p>ocean user's guide: add governing equations, adjust locations of bib files.<br>
</p><hr noshade><pre><font color="gray">Deleted: trunk/documents/users_guide/mpas_ocean.bib
===================================================================
--- trunk/documents/users_guide/mpas_ocean.bib        2013-03-07 16:08:30 UTC (rev 2552)
+++ trunk/documents/users_guide/mpas_ocean.bib        2013-03-07 17:55:03 UTC (rev 2553)
@@ -1,249 +0,0 @@
-mpas-ocean  bibliography file
-
-These references are specifically for the mpas-ocean core.
-See the mpas_shared.bib file for references pertaining to all cores.
-
-%%%%%%%% grid and numerics %%%%%%%%%
-
-@unpublished{Ringler06unpub,
-   author = {{Ringler}, T.~D.},
-    title = &quot;{Conservation of energy in viscous systems}&quot;,
-   institution = {Los Alamos National Laboratory},
-     year = 2006,
-     month = &quot;June&quot;
-}
-
-
-%%%%%%%% test domains %%%%%%%%%
-
-@ARTICLE{Ilicak_ea12om,
-   author = {{Ilicak}, M. and {Adcroft}, A.~J. and {Griffies}, S.~M. and 
-        {Hallberg}, R.~W.},
-    title = &quot;{Spurious dianeutral mixing and the role of momentum closure}&quot;,
-  journal = {Ocean Modelling},
-     year = 2012,
-   volume = 45,
-    pages = {37-58},
-      doi = {10.1016/j.ocemod.2011.10.003},
-   adsurl = {http://adsabs.harvard.edu/abs/2012OcMod..45...37I},
-  adsnote = {Provided by the SAO/NASA Astrophysics Data System}
-}
-
-@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;,
-  journal = {Ocean Modelling},
-     year = 2006,
-   volume = 11,
-    pages = {69-97}}
-
-
-%%%%%%%% horizonal turbulence closures %%%%%%%%%
-
-@article{Gent_McWilliams90jpo,
-author=&quot;Peter R. Gent and James C. {McW}illiams&quot;,
-title=&quot;Isopycnal Mixing in Ocean Circulation Models&quot;,
-journal={\jpo},
-year=1990,
-volume=20,
-number=1,
-pages=&quot;150-155&quot;}
-
-@article{Gent_ea95jpo,
-author=&quot;Peter R. Gent and Jurgen Willebrand and Trevor McDougall and James C. McWilliams&quot;,
-title=&quot;Parameterizing eddy-induced tracer transports in ocean general circulation models&quot;,
-journal={\jpo},
-year=1995,
-volume=25,
-number=25,
-pages=&quot;463-474&quot;}
-
-@article{Leith:1996wu,
-author = {Leith, CE},
-title = {{Stochastic models of chaotic systems}},
-journal = {Physica D: Nonlinear Phenomena},
-year = {1996},
-volume = {98},
-number = {2-4},
-pages = {481--491} 
-}
-
-@ARTICLE{Ringler_Gent11om,
-  author = {{Ringler}, T.~D. and {Gent}, D.~A.},
-  title = &quot;{An eddy closure for potential vorticity}&quot;,
-  journal = {Ocean Modelling},
-  year = 2011,
-   note=&quot;in press&quot;
-}
-
-
-%%%%%%%% vertical mixing %%%%%%%%%
-
-@article{Pacanowski_Philander81jpo,
-title=&quot;Parameterization of Vertical Mixing in Numerical Models of Tropical Oceans&quot;,
-author=&quot;R.C. Pacanowski and S.G.H. Philander&quot;,
-journal={\jpo},
-year=1981,
-volume=11,
-number=11,
-pages=&quot;1443-1451&quot;}
-
-@article{Large:1994ua,
-author = {Large, W G and McWilliams, J C and Doney, S C},
-title = {{Oceanic vertical mixing: A review and a model with a nonlocal boundary layer parameterization}},
-journal = {Reviews of Geophysics},
-year = {1994},
-volume = {32},
-number = {4},
-pages = {363--403}
-}
-
-
-%%%%%%%% vertical coordinates %%%%%%%%%
-
-@ARTICLE{Adcroft_Campin04om,
-   author = {{Adcroft}, A. and {Campin}, J.-M.},
-    title = &quot;{Rescaled height coordinates for accurate representation of free-surface flows in ocean circulation models}&quot;,
-  journal = {Ocean Modelling},
-     year = 2004,
-   volume = 7,
-    pages = {269-284},
-      doi = {10.1016/j.ocemod.2003.09.003},
-   adsurl = {http://adsabs.harvard.edu/abs/2004OcMod...7..269A},
-  adsnote = {Provided by the SAO/NASA Astrophysics Data System}
-}
-
-@ARTICLE{Campin_ea04om,
-   author = {{Campin}, J.-M. and {Adcroft}, A. and {Hill}, C. and {Marshall}, J.
-        },
-    title = &quot;{Conservation of properties in a free-surface model}&quot;,
-  journal = {Ocean Modelling},
-     year = 2004,
-   volume = 6,
-    pages = {221-244},
-      doi = {10.1016/S1463-5003(03)00009-X},
-   adsurl = {http://adsabs.harvard.edu/abs/2004OcMod...6..221C},
-  adsnote = {Provided by the SAO/NASA Astrophysics Data System}
-}
-
-@ARTICLE{Leclair_Madec11om,
-   author = {{Leclair}, M. and {Madec}, G.},
-    title = &quot;{-Coordinate, an Arbitrary Lagrangian-Eulerian coordinate separating high and low frequency motions}&quot;,
-  journal = {Ocean Modelling},
-     year = 2011,
-   volume = 37,
-    pages = {139-152},
-   adsurl = {http://adsabs.harvard.edu/abs/2011OcMod..37..139L},
-  adsnote = {Provided by the SAO/NASA Astrophysics Data System}
-}
-
-@ARTICLE{Bernard_ea06od,
-   author = {{Bernard}, B. and {Madec}, G. and {Penduff}, T. and {Molines}, J.-M. and 
-        {Treguier}, A.-M. and {Le Sommer}, J. and {Beckmann}, A. and 
-        {Biastoch}, A. and {B{\&quot;o}ning}, C. and {Dengg}, J. and {Derval}, C. and 
-        {Durand}, E. and {Gulev}, S. and {Remy}, E. and {Talandier}, C. and 
-        {Theetten}, S. and {Maltrud}, M. and {McClean}, J. and {de Cuevas}, B.
-        },
-    title = &quot;{Impact of partial steps and momentum advection schemes in a global ocean circulation model at eddy-permitting resolution}&quot;,
-  journal = {Ocean Dynamics},
- keywords = {Global ocean, Eddy-permitting ocean model, Momentum advection scheme, Partial step topography, Eddy/topography interactions},
-     year = 2006,
-    month = dec,
-   volume = 56,
-    pages = {543-567},
-      doi = {10.1007/s10236-006-0082-1},
-   adsurl = {http://adsabs.harvard.edu/abs/2006OcDyn..56..543B},
-  adsnote = {Provided by the SAO/NASA Astrophysics Data System}
-}
-
-%%%%%%%% time integration %%%%%
-
-@ARTICLE{Higdon02jcp,
-   author = {{Higdon}, R.~L.},
-    title = &quot;{A Two-Level Time-Stepping Method for Layered Ocean Circulation Models}&quot;,
-  journal = {Journal of Computational Physics},
-     year = 2002,
-    month = mar,
-   volume = 177,
-    pages = {59-94},
-      doi = {10.1006/jcph.2002.7003},
-   adsurl = {http://adsabs.harvard.edu/abs/2002JCoPh.177...59H}}
-
-@ARTICLE{Higdon05jcp,
-   author = {{Higdon}, R.~L.},
-    title = &quot;{A two-level time-stepping method for layered ocean circulation models: further development and testing}&quot;,
-  journal = {Journal of Computational Physics},
-     year = 2005,
-    month = jul,
-   volume = 206,
-    pages = {463-504},
-      doi = {10.1016/j.jcp.2004.12.011},
-   adsurl = {http://adsabs.harvard.edu/abs/2005JCoPh.206..463H}}
-
-@article{Shchepetkin:2005wm,
-author = {Shchepetkin, A F and McWilliams, J C},
-title = {{The regional oceanic modeling system (ROMS): a split-explicit, free-surface, topography-following-coordinate oceanic model}},
-journal = {Ocean Modelling},
-year = {2005},
-volume = {9},
-number = {4},
-pages = {347--404}
-}
-
-%%%%% partial bottom cells %%%%
-
-@ARTICLE{Adcroft_ea97mwr,
-   author = {{Adcroft}, A. and {Hill}, C. and {Marshall}, J.},
-    title = &quot;{Representation of Topography by Shaved Cells in a Height Coordinate Ocean Model}&quot;,
-  journal = {Monthly Weather Review},
-     year = 1997,
-   volume = 125,
-    pages = {2293},
-      doi = {10.1175/1520-0493(1997)125&lt;2293:ROTBSC&gt;2.0.CO;2},
-   adsurl = {http://adsabs.harvard.edu/abs/1997MWRv..125.2293A},
-  adsnote = {Provided by the SAO/NASA Astrophysics Data System}
-}
-
-@ARTICLE{1998MWRv..126.3248P,
-   author = {{Pacanowski}, R.~C. and {Gnanadesikan}, A.},
-    title = &quot;{Transient Response in a Z-Level Ocean Model That Resolves Topography with Partial Cells}&quot;,
-  journal = {Monthly Weather Review},
-     year = 1998,
-   volume = 126,
-    pages = {3248},
-      doi = {10.1175/1520-0493(1998)126&lt;3248:TRIAZL&gt;2.0.CO;2},
-   adsurl = {http://adsabs.harvard.edu/abs/1998MWRv..126.3248P},
-  adsnote = {Provided by the SAO/NASA Astrophysics Data System}
-}
-
-%%% equation of state %%%
-
-@ARTICLE{Jackett_McDougall95jaot,
-   author = {{Jackett}, D.~R. and {McDougall}, T.~J.},
-    title = &quot;{Minimal Adjustment of Hydrographic Profiles to Achieve Static Stability}&quot;,
-  journal = {Journal of Atmospheric and Oceanic Technology},
-     year = 1995,
-    month = apr,
-   volume = 12,
-    pages = {381},
-      doi = {10.1175/1520-0426(1995)012&lt;0381:MAOHPT&gt;2.0.CO;2},
-   adsurl = {http://adsabs.harvard.edu/abs/1995JAtOT..12..381J},
-  adsnote = {Provided by the SAO/NASA Astrophysics Data System}
-}
-
-%%% reference textbooks %%%
-
-@book{Iserles96bk,
-author=&quot;A. Iserles&quot;,
-title=&quot;A first course in the numerical analysis of differential equations&quot;,
-year=1996,
-edition=&quot;first&quot;,
-publisher=&quot;Cambridge University Press&quot;}
-
-@book{Kundu_ea12bk,
-author=&quot;P. K. Kundu and I. M. Cohen and D. R. Dowling&quot;,
-title=&quot;Fluid Mechanics&quot;,
-year=2012,
-edition=&quot;Fifth&quot;,
-publisher=&quot;Academic Press&quot;}
-

Modified: trunk/documents/users_guide/mpas_ocean_users_guide.tex
===================================================================
--- trunk/documents/users_guide/mpas_ocean_users_guide.tex        2013-03-07 16:08:30 UTC (rev 2552)
+++ trunk/documents/users_guide/mpas_ocean_users_guide.tex        2013-03-07 17:55:03 UTC (rev 2553)
@@ -7,8 +7,7 @@
 \usepackage{color}
 \usepackage{caption}
 \usepackage[hang]{subfigure}
-% this will include the bibliography as a numbered chapter:
-\usepackage[nottoc,numbib]{tocbibind}
+\usepackage{natbib}
 
 \definecolor{black}{rgb}{0.0,0.0,0.0}
 \definecolor{darkblue}{rgb}{0.0,0.0,0.5}
@@ -34,22 +33,28 @@
 
 \begin{document}
 
-\title{MPAS - Ocean Model Users Guide}
+\title{MPAS-Ocean Model User's Guide}
 
-\author{MPAS-Developer Team}
+\author{MPAS-Ocean Developement Team:\\Doug Jacobsen, Mark Petersen, Todd Ringer
+\\Los Alamos National Laboratory
+\\
+\\with contributions by Qingshan Chen, more
+\\Los Alamos National Laboratory
+\\Michael Duda, list more
+\\The National Center for Atmospheric Research
+}
 
 \maketitle
 \tableofcontents
 
-%\part{Quick Start}
 \input{ocn/quick_start.tex}
 
-\part{Introduction}
+\part{The MPAS Framework}
 \input{shared/mpas_build_instructions.tex}
 \input{shared/mpas_grid_information.tex}
 \input{shared/mpas_visualization.tex}
 
-\part{Ocean Model Specifics}
+\part{MPAS-Ocean}
 \input{ocn/core_intro.tex}
 \input{ocn/dimension_table_documentation.tex}
 \input{ocn/namelist_table_documentation.tex}
@@ -59,8 +64,9 @@
 \input{ocn/cesm_coupling.tex}
 \input{ocn/troubleshooting.tex}
 
-\bibliographystyle{alpha}
-\bibliography{mpas_ocean,mpas_shared}
+\part{Bibliography}
+\bibliographystyle{shared/ametsoc}
+\bibliography{shared/mpas_shared,ocn/mpas_ocean}
 
 \part{Appendices}
 \appendix

Deleted: trunk/documents/users_guide/mpas_shared.bib
===================================================================
--- trunk/documents/users_guide/mpas_shared.bib        2013-03-07 16:08:30 UTC (rev 2552)
+++ trunk/documents/users_guide/mpas_shared.bib        2013-03-07 17:55:03 UTC (rev 2553)
@@ -1,112 +0,0 @@
-mpas shared bibliography file
-
-These references should apply to all mpas cores.
-
-%%%%%%%% mpas grid %%%%%%%%%
-
-@ARTICLE{Thurburn_ea09jcp,
-   author = {{Thuburn}, J. and {Ringler}, T.~D. and {Skamarock}, W.~C. and 
-        {Klemp}, J.~B.},
-    title = &quot;{Numerical representation of geostrophic modes on arbitrarily structured C-grids}&quot;,
-  journal = {Journal of Computational Physics},
-     year = 2009,
-    month = dec,
-   volume = 228,
-    pages = {8321-8335},
-      doi = {10.1016/j.jcp.2009.08.006},
-   adsurl = {http://adsabs.harvard.edu/abs/2009JCoPh.228.8321T},
-  adsnote = {Provided by the SAO/NASA Astrophysics Data System}
-}
-
-@ARTICLE{Ringler_ea10jcp,
-   author = {{Ringler}, T.~D. and {Thuburn}, J. and {Klemp}, J.~B. and {Skamarock}, W.~C.
-        },
-    title = &quot;{A unified approach to energy conservation and potential vorticity dynamics for arbitrarily-structured C-grids}&quot;,
-  journal = {J. Comp. Physics},
-     year = 2010,
-    month = may,
-   volume = 229,
-    pages = {3065-3090},
-      doi = {10.1016/j.jcp.2009.12.007},
-   adsurl = {http://adsabs.harvard.edu/abs/2010JCoPh.229.3065R},
-  adsnote = {Provided by the SAO/NASA Astrophysics Data System}
-}
-
-@ARTICLE{Ringler_ea08od,
-   author = {{Ringler}, T. and {Ju}, L. and {Gunzburger}, M.},
-    title = &quot;{A multiresolution method for climate system modeling: application of spherical centroidal Voronoi tessellations}&quot;,
-  journal = {Ocean Dynamics},
- keywords = {Voronoi diagram, Delaunay triangulation, Climate modeling, Multiresolution},
-     year = 2008,
-    month = dec,
-   volume = 58,
-    pages = {475-498},
-      doi = {10.1007/s10236-008-0157-2},
-   adsurl = {http://adsabs.harvard.edu/abs/2008OcDyn..58..475R},
-  adsnote = {Provided by the SAO/NASA Astrophysics Data System}
-}
-
-@article{Du:1999un,
-author = {Du, Q and Gunzburger, M},
-title = {{Centroidal Voronoi tessellations: applications and algorithms}},
-journal = {SIAM review},
-year = {1999},
-volume = {41},
-number = {4},
-pages = {637--676}
-}
-
-@book{OBSC2000,
-author = {Okabe, A and Boots, B and Sugihara, K and Chiu, S},
-title = {{Spatial Tessellations: Concepts and Applications of Voronoi Diagrams}},
-publisher = {Wiley},
-year = {2009}
-}
-
-@article{Ju:2010vi,
-author = {Ju, L and Ringler, T and Gunzburger, M},
-title = {{Voronoi Tessellations and their Application to Climate and Global Modeling}},
-journal = {Numerical Techniques for Global Atmospheric Models,
-Springer Lecture Notes in Computational Science and Engineering,
-Eds. P. H. Lauritzen, C. Jablonowski, M. A. Taylor and
-R. D. Nair},
-year = {2010},
-pages = {1--30}
-}
-
-@ARTICLE{Ringler_Randall02mwr,
-   author = {{Ringler}, T.~D. and {Randall}, D.~A.},
-    title = &quot;{A Potential Enstrophy and Energy Conserving Numerical Scheme for Solution of the Shallow-Water Equations on a Geodesic Grid}&quot;,
-  journal = {Monthly Weather Review},
-     year = 2002,
-   volume = 130,
-    pages = {1397-+},
-      doi = {10.1175/1520-0493(2002)130&lt;1397:APEAEC&gt;2.0.CO;2},
-   adsurl = {http://adsabs.harvard.edu/abs/2002MWRv..130.1397R},
-  adsnote = {Provided by the SAO/NASA Astrophysics Data System}
-}
-
-
-%%%%%%%% advection schemes %%%%%%%%%
-
-@ARTICLE{Miura07mwr,
-   author = {{Miura}, H.},
-    title = &quot;{An Upwind-Biased Conservative Advection Scheme for Spherical Hexagonal Pentagonal Grids}&quot;,
-  journal = {Monthly Weather Review},
-     year = 2007,
-   volume = 135,
-    pages = {4038},
-      doi = {10.1175/2007MWR2101.1},
-   adsurl = {http://adsabs.harvard.edu/abs/2007MWRv..135.4038M},
-  adsnote = {Provided by the SAO/NASA Astrophysics Data System}
-}
-
-@article{Skamarock:2011tc,
-author = {Skamarock, W.C. and Gassmann, A.},
-title = {{Conservative Transport Schemes for Spherical Geodesic Grids: High-Order Flux Operators for ODE-Based Time Integration}},
-journal = {Monthly Weather Review},
-year = {2011},
-volume = {139},
-number = {9},
-pages = {2962--2975}
-}

Modified: trunk/documents/users_guide/ocn/core_intro.tex
===================================================================
--- trunk/documents/users_guide/ocn/core_intro.tex        2013-03-07 16:08:30 UTC (rev 2552)
+++ trunk/documents/users_guide/ocn/core_intro.tex        2013-03-07 17:55:03 UTC (rev 2553)
@@ -1,4 +1,94 @@
-\chapter{Ocean Introduction}
+\chapter{Governing Equations}
 \label{chap:ocean-intro}
 
+The governing equations for MPAS-Ocean, in continuous form, are\\
+{\it momentum equation:}
+\begin{equation}
+\label{ocn:momentum continuous 1}
+\frac{\partial {\bf u}}{\partial t} 
++ \eta {\bf k} \times {\bf u}
++ w\frac{\partial {\bf u}}{\partial z}
+  = - \frac{1}{\rho_0}</font>
<font color="black">abla p - </font>
<font color="blue">abla K
++ {\bf D}^u_h + {\bf D}^u_v
+\end{equation}
+{\it thickness equation:}
+\begin{equation}
+\label{ocn:thickness continuous 1}
+\frac{\partial h}{\partial t}
++ </font>
<font color="blue">abla\cdot\left(h \overline{ {\bf u} }^z\right)
++ \left.  w \right|_{z=s^{top}} 
+- \left.  w \right|_{z=s^{bot}} 
+= 0
+\end{equation}
+{\it tracer equation:}
+\begin{equation}
+\label{ocn:tracer continuous 1}
+\frac{\partial}{\partial t} h \overline{\varphi}^z
++ </font>
<font color="blue">abla\cdot\left(h \overline{\varphi {\bf u} }^z\right)
++ \left. \varphi w \right|_{z=s^{top}} 
+- \left. \varphi w \right|_{z=s^{bot}} 
+=  D^\varphi_h +  D^\varphi_v
+\end{equation}
+{\it hydrostatic condition:}
+\begin{equation}
+\label{ocn:pressure continuous 1}
+p(x,y,z) = p^{s}(x,y) + \int_{z}^{z^s} \rho g dz'
+\end{equation}
+{\it equation of state:}
+\begin{equation}
+\label{ocn:eos continuous 1}
+\rho = f_{eos}(\Theta,S,p)
+\end{equation}
 
+Equations \ref{ocn:momentum continuous 1} through \ref{ocn:eos continuous 1} are a normal expression of the primitive equations; i.e. the incompressible Boussinesq equations in hydrostatic balance.  Variable definitions are in Tables \ref{ocnTable:variables} and \ref{ocnTable:variables_Greek}.  The momentum advection and Coriolis terms in (\ref{ocn:momentum continuous 1}) are presented in vorticity-kinetic energy form \citep[eqn 5]{Ringler_ea10jcp}.  
+
+
+\begin{table}[ht] 
+\caption{Latin variables used in prognostic equation set.  Column 3 shows the native horizontal grid location.  All variables are located at the center of the layer in the vertical.} 
+\vspace{0.5cm} \centering 
+\begin{tabular}{c c c c } 
+\hline\hline symbol &amp;  name &amp; grid &amp;  notes  \\
+\hline 
+${\bf D}^u_h$, ${\bf D}^u_v$  &amp; mom. diffusion terms &amp; edge &amp; $h$ horizonal, $v$ vertical\\ 
+$ D^\varphi_h$, $ D^\varphi_v$ &amp; tracer diff. terms &amp; cell &amp; \\ 
+$f$ &amp; Coriolis parameter &amp; vertex \\
+$f_{eos}$ &amp; equation of state &amp; -  \\
+$g$ &amp; grav. acceleration &amp; constant  \\
+$h$ &amp; layer thickness &amp; cell &amp;\\
+${\bf k}$ &amp; vertical unit vector &amp;  \\
+$K$ &amp;  kinetic energy &amp; edge  &amp; $K = \left| {\bf u} \right|^2 / 2$ \\
+$p$ &amp; pressure &amp; cell \\
+$p^s$ &amp; surface pressure &amp; cell \\ 
+$q$ &amp; potential vorticity &amp; vertex &amp; $q=\eta/h$ \\
+$s^{bot}$ &amp; z-location of bottom of layer &amp; cell \\
+$s^{top}$ &amp; z-location of top of layer &amp; cell \\
+$S$ &amp; salinity &amp; cell &amp;  a tracer $\varphi$  \\
+$t$ &amp; time &amp; -  \\
+$u$ &amp; horizontal velocity &amp; edge  &amp; normal component to edge\\
+${\bf u}$ &amp; horizontal velocity   &amp; - \\
+${\bf v}$ &amp; 3D velocity   &amp; - \\
+$w$ &amp; vertical transport &amp; cell  &amp; determined by coord. type \\
+$z$ &amp; vertical coordinate &amp; - &amp; positive upward \\
+$z^{s}$ &amp; sea surface location &amp; cell \\
+\hline 
+\end{tabular} \label{ocnTable:variables} 
+\end{table}
+
+\begin{table}[ht] 
+\caption{Greek variables used in prognostic equation set.  Column 3 shows the native horizontal grid location.  All variables are located at the center of the layer in the vertical.} 
+\vspace{0.5cm} \centering 
+\begin{tabular}{c c c c} 
+\hline\hline symbol &amp;  name &amp; grid &amp; notes  \\
+\hline 
+$\delta$ &amp; horizontal divergence &amp; cell  &amp; $\delta=</font>
<font color="blue">abla\cdot{\bf u}$  \\
+$\zeta$ &amp; sea surface height &amp; cell   \\
+$\eta$ &amp; absolute vorticity &amp; vertex  &amp; $\eta={\bf k} \cdot </font>
<font color="blue">abla \times {\bf u}+f$ \\
+$\Theta$ &amp; potential temperature &amp; cell  &amp; a tracer $\varphi$ \\
+$\kappa_h$, $\kappa_h$ &amp; diffusion &amp; cell \\ 
+$</font>
<font color="black">u_h$, $</font>
<font color="gray">u_v$ &amp; viscosity &amp; edge \\
+$\rho$ &amp; density &amp; cell  \\
+$\rho_0$ &amp; reference density &amp; constant &amp; \\
+$\varphi$ &amp; generic tracer &amp; cell &amp; e.g. $\Theta$, $S$ \\
+\hline 
+\end{tabular} \label{ocnTable:variables_Greek} 
+\end{table}

Added: trunk/documents/users_guide/ocn/mpas_ocean.bib
===================================================================
--- trunk/documents/users_guide/ocn/mpas_ocean.bib                                (rev 0)
+++ trunk/documents/users_guide/ocn/mpas_ocean.bib        2013-03-07 17:55:03 UTC (rev 2553)
@@ -0,0 +1,249 @@
+mpas-ocean  bibliography file
+
+These references are specifically for the mpas-ocean core.
+See the mpas_shared.bib file for references pertaining to all cores.
+
+%%%%%%%% grid and numerics %%%%%%%%%
+
+@unpublished{Ringler06unpub,
+   author = {{Ringler}, T.~D.},
+    title = &quot;{Conservation of energy in viscous systems}&quot;,
+   institution = {Los Alamos National Laboratory},
+     year = 2006,
+     month = &quot;June&quot;
+}
+
+
+%%%%%%%% test domains %%%%%%%%%
+
+@ARTICLE{Ilicak_ea12om,
+   author = {{Ilicak}, M. and {Adcroft}, A.~J. and {Griffies}, S.~M. and 
+        {Hallberg}, R.~W.},
+    title = &quot;{Spurious dianeutral mixing and the role of momentum closure}&quot;,
+  journal = {Ocean Modelling},
+     year = 2012,
+   volume = 45,
+    pages = {37-58},
+      doi = {10.1016/j.ocemod.2011.10.003},
+   adsurl = {http://adsabs.harvard.edu/abs/2012OcMod..45...37I},
+  adsnote = {Provided by the SAO/NASA Astrophysics Data System}
+}
+
+@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;,
+  journal = {Ocean Modelling},
+     year = 2006,
+   volume = 11,
+    pages = {69-97}}
+
+
+%%%%%%%% horizonal turbulence closures %%%%%%%%%
+
+@article{Gent_McWilliams90jpo,
+author=&quot;Peter R. Gent and James C. {McW}illiams&quot;,
+title=&quot;Isopycnal Mixing in Ocean Circulation Models&quot;,
+journal={\jpo},
+year=1990,
+volume=20,
+number=1,
+pages=&quot;150-155&quot;}
+
+@article{Gent_ea95jpo,
+author=&quot;Peter R. Gent and Jurgen Willebrand and Trevor McDougall and James C. McWilliams&quot;,
+title=&quot;Parameterizing eddy-induced tracer transports in ocean general circulation models&quot;,
+journal={\jpo},
+year=1995,
+volume=25,
+number=25,
+pages=&quot;463-474&quot;}
+
+@article{Leith:1996wu,
+author = {Leith, CE},
+title = {{Stochastic models of chaotic systems}},
+journal = {Physica D: Nonlinear Phenomena},
+year = {1996},
+volume = {98},
+number = {2-4},
+pages = {481--491} 
+}
+
+@ARTICLE{Ringler_Gent11om,
+  author = {{Ringler}, T.~D. and {Gent}, D.~A.},
+  title = &quot;{An eddy closure for potential vorticity}&quot;,
+  journal = {Ocean Modelling},
+  year = 2011,
+   note=&quot;in press&quot;
+}
+
+
+%%%%%%%% vertical mixing %%%%%%%%%
+
+@article{Pacanowski_Philander81jpo,
+title=&quot;Parameterization of Vertical Mixing in Numerical Models of Tropical Oceans&quot;,
+author=&quot;R.C. Pacanowski and S.G.H. Philander&quot;,
+journal={\jpo},
+year=1981,
+volume=11,
+number=11,
+pages=&quot;1443-1451&quot;}
+
+@article{Large:1994ua,
+author = {Large, W G and McWilliams, J C and Doney, S C},
+title = {{Oceanic vertical mixing: A review and a model with a nonlocal boundary layer parameterization}},
+journal = {Reviews of Geophysics},
+year = {1994},
+volume = {32},
+number = {4},
+pages = {363--403}
+}
+
+
+%%%%%%%% vertical coordinates %%%%%%%%%
+
+@ARTICLE{Adcroft_Campin04om,
+   author = {{Adcroft}, A. and {Campin}, J.-M.},
+    title = &quot;{Rescaled height coordinates for accurate representation of free-surface flows in ocean circulation models}&quot;,
+  journal = {Ocean Modelling},
+     year = 2004,
+   volume = 7,
+    pages = {269-284},
+      doi = {10.1016/j.ocemod.2003.09.003},
+   adsurl = {http://adsabs.harvard.edu/abs/2004OcMod...7..269A},
+  adsnote = {Provided by the SAO/NASA Astrophysics Data System}
+}
+
+@ARTICLE{Campin_ea04om,
+   author = {{Campin}, J.-M. and {Adcroft}, A. and {Hill}, C. and {Marshall}, J.
+        },
+    title = &quot;{Conservation of properties in a free-surface model}&quot;,
+  journal = {Ocean Modelling},
+     year = 2004,
+   volume = 6,
+    pages = {221-244},
+      doi = {10.1016/S1463-5003(03)00009-X},
+   adsurl = {http://adsabs.harvard.edu/abs/2004OcMod...6..221C},
+  adsnote = {Provided by the SAO/NASA Astrophysics Data System}
+}
+
+@ARTICLE{Leclair_Madec11om,
+   author = {{Leclair}, M. and {Madec}, G.},
+    title = &quot;{-Coordinate, an Arbitrary Lagrangian-Eulerian coordinate separating high and low frequency motions}&quot;,
+  journal = {Ocean Modelling},
+     year = 2011,
+   volume = 37,
+    pages = {139-152},
+   adsurl = {http://adsabs.harvard.edu/abs/2011OcMod..37..139L},
+  adsnote = {Provided by the SAO/NASA Astrophysics Data System}
+}
+
+@ARTICLE{Bernard_ea06od,
+   author = {{Bernard}, B. and {Madec}, G. and {Penduff}, T. and {Molines}, J.-M. and 
+        {Treguier}, A.-M. and {Le Sommer}, J. and {Beckmann}, A. and 
+        {Biastoch}, A. and {B{\&quot;o}ning}, C. and {Dengg}, J. and {Derval}, C. and 
+        {Durand}, E. and {Gulev}, S. and {Remy}, E. and {Talandier}, C. and 
+        {Theetten}, S. and {Maltrud}, M. and {McClean}, J. and {de Cuevas}, B.
+        },
+    title = &quot;{Impact of partial steps and momentum advection schemes in a global ocean circulation model at eddy-permitting resolution}&quot;,
+  journal = {Ocean Dynamics},
+ keywords = {Global ocean, Eddy-permitting ocean model, Momentum advection scheme, Partial step topography, Eddy/topography interactions},
+     year = 2006,
+    month = dec,
+   volume = 56,
+    pages = {543-567},
+      doi = {10.1007/s10236-006-0082-1},
+   adsurl = {http://adsabs.harvard.edu/abs/2006OcDyn..56..543B},
+  adsnote = {Provided by the SAO/NASA Astrophysics Data System}
+}
+
+%%%%%%%% time integration %%%%%
+
+@ARTICLE{Higdon02jcp,
+   author = {{Higdon}, R.~L.},
+    title = &quot;{A Two-Level Time-Stepping Method for Layered Ocean Circulation Models}&quot;,
+  journal = {Journal of Computational Physics},
+     year = 2002,
+    month = mar,
+   volume = 177,
+    pages = {59-94},
+      doi = {10.1006/jcph.2002.7003},
+   adsurl = {http://adsabs.harvard.edu/abs/2002JCoPh.177...59H}}
+
+@ARTICLE{Higdon05jcp,
+   author = {{Higdon}, R.~L.},
+    title = &quot;{A two-level time-stepping method for layered ocean circulation models: further development and testing}&quot;,
+  journal = {Journal of Computational Physics},
+     year = 2005,
+    month = jul,
+   volume = 206,
+    pages = {463-504},
+      doi = {10.1016/j.jcp.2004.12.011},
+   adsurl = {http://adsabs.harvard.edu/abs/2005JCoPh.206..463H}}
+
+@article{Shchepetkin:2005wm,
+author = {Shchepetkin, A F and McWilliams, J C},
+title = {{The regional oceanic modeling system (ROMS): a split-explicit, free-surface, topography-following-coordinate oceanic model}},
+journal = {Ocean Modelling},
+year = {2005},
+volume = {9},
+number = {4},
+pages = {347--404}
+}
+
+%%%%% partial bottom cells %%%%
+
+@ARTICLE{Adcroft_ea97mwr,
+   author = {{Adcroft}, A. and {Hill}, C. and {Marshall}, J.},
+    title = &quot;{Representation of Topography by Shaved Cells in a Height Coordinate Ocean Model}&quot;,
+  journal = {Monthly Weather Review},
+     year = 1997,
+   volume = 125,
+    pages = {2293},
+      doi = {10.1175/1520-0493(1997)125&lt;2293:ROTBSC&gt;2.0.CO;2},
+   adsurl = {http://adsabs.harvard.edu/abs/1997MWRv..125.2293A},
+  adsnote = {Provided by the SAO/NASA Astrophysics Data System}
+}
+
+@ARTICLE{1998MWRv..126.3248P,
+   author = {{Pacanowski}, R.~C. and {Gnanadesikan}, A.},
+    title = &quot;{Transient Response in a Z-Level Ocean Model That Resolves Topography with Partial Cells}&quot;,
+  journal = {Monthly Weather Review},
+     year = 1998,
+   volume = 126,
+    pages = {3248},
+      doi = {10.1175/1520-0493(1998)126&lt;3248:TRIAZL&gt;2.0.CO;2},
+   adsurl = {http://adsabs.harvard.edu/abs/1998MWRv..126.3248P},
+  adsnote = {Provided by the SAO/NASA Astrophysics Data System}
+}
+
+%%% equation of state %%%
+
+@ARTICLE{Jackett_McDougall95jaot,
+   author = {{Jackett}, D.~R. and {McDougall}, T.~J.},
+    title = &quot;{Minimal Adjustment of Hydrographic Profiles to Achieve Static Stability}&quot;,
+  journal = {Journal of Atmospheric and Oceanic Technology},
+     year = 1995,
+    month = apr,
+   volume = 12,
+    pages = {381},
+      doi = {10.1175/1520-0426(1995)012&lt;0381:MAOHPT&gt;2.0.CO;2},
+   adsurl = {http://adsabs.harvard.edu/abs/1995JAtOT..12..381J},
+  adsnote = {Provided by the SAO/NASA Astrophysics Data System}
+}
+
+%%% reference textbooks %%%
+
+@book{Iserles96bk,
+author=&quot;A. Iserles&quot;,
+title=&quot;A first course in the numerical analysis of differential equations&quot;,
+year=1996,
+edition=&quot;first&quot;,
+publisher=&quot;Cambridge University Press&quot;}
+
+@book{Kundu_ea12bk,
+author=&quot;P. K. Kundu and I. M. Cohen and D. R. Dowling&quot;,
+title=&quot;Fluid Mechanics&quot;,
+year=2012,
+edition=&quot;Fifth&quot;,
+publisher=&quot;Academic Press&quot;}
+

Modified: trunk/documents/users_guide/ocn/test_case_descriptions.tex
===================================================================
--- trunk/documents/users_guide/ocn/test_case_descriptions.tex        2013-03-07 16:08:30 UTC (rev 2552)
+++ trunk/documents/users_guide/ocn/test_case_descriptions.tex        2013-03-07 17:55:03 UTC (rev 2553)
@@ -1,4 +1,4 @@
-\chapter{MPAS-Ocean Test Cases}
+\chapter{Test Cases}
 \label{chap:ocean_test_cases}
 
 \input{ocn/test_cases/baroclinic_channel.tex}

Added: trunk/documents/users_guide/shared/ametsoc.bst
===================================================================
--- trunk/documents/users_guide/shared/ametsoc.bst                                (rev 0)
+++ trunk/documents/users_guide/shared/ametsoc.bst        2013-03-07 17:55:03 UTC (rev 2553)
@@ -0,0 +1,1741 @@
+%%
+%% This is file `ametsoc.bst',
+%% generated with the docstrip utility.
+%%
+%% The original source files were:
+%%
+%% merlin.mbs  (with options: `,ay,nat,nm-rev1,nmdash,dt-beg,note-yr,vol-bf,vnum-x,volp-com,pp-last,bkpg-x,pg-bk,pre-pub,url,url-nl,edby,edbyy,blk-tit,au-col,in-x,pp,ed,xedn,jabr,em-it')
+%% ----------------------------------------
+%% *** Lakshman (Nov. 1999), for American Meteorological Society publications ***
+%% 
+%% Copyright 1994-1999 Patrick W Daly
+ % ===============================================================
+ % IMPORTANT NOTICE:
+ % This bibliographic style (bst) file has been generated from one or
+ % more master bibliographic style (mbs) files, listed above.
+ %
+ % This generated file can be redistributed and/or modified under the terms
+ % of the LaTeX Project Public License Distributed from CTAN
+ % archives in directory macros/latex/base/lppl.txt; either
+ % version 1 of the License, or any later version.
+ % ===============================================================
+ % Name and version information of the main mbs file:
+ % \ProvidesFile{merlin.mbs}[1999/03/18 3.88 (PWD)]
+ %   For use with BibTeX version 0.99a or later
+ %-------------------------------------------------------------------
+ % This bibliography style file is intended for texts in ENGLISH
+ % This is an author-year citation style bibliography. As such, it is
+ % non-standard LaTeX, and requires a special package file to function properly.
+ % Such a package is    natbib.sty   by Patrick W. Daly
+ % The form of the \bibitem entries is
+ %   \bibitem[Jones et al.(1990)]{key}...
+ %   \bibitem[Jones et al.(1990)Jones, Baker, and Smith]{key}...
+ % The essential feature is that the label (the part in brackets) consists
+ % of the author names, as they should appear in the citation, with the year
+ % in parentheses following. There must be no space before the opening
+ % parenthesis!
+ % With natbib v5.3, a full list of authors may also follow the year.
+ % In natbib.sty, it is possible to define the type of enclosures that is
+ % really wanted (brackets or parentheses), but in either case, there must
+ % be parentheses in the label.
+ % The \cite command functions as follows:
+ %   \citet{key} ==&gt;&gt;                Jones et al. (1990)
+ %   \citet*{key} ==&gt;&gt;               Jones, Baker, and Smith (1990)
+ %   \citep{key} ==&gt;&gt;                (Jones et al., 1990)
+ %   \citep*{key} ==&gt;&gt;               (Jones, Baker, and Smith, 1990)
+ %   \citep[chap. 2]{key} ==&gt;&gt;       (Jones et al., 1990, chap. 2)
+ %   \citep[e.g.][]{key} ==&gt;&gt;        (e.g. Jones et al., 1990)
+ %   \citep[e.g.][p. 32]{key} ==&gt;&gt;   (e.g. Jones et al., p. 32)
+ %   \citeauthor{key} ==&gt;&gt;           Jones et al.
+ %   \citeauthor*{key} ==&gt;&gt;          Jones, Baker, and Smith
+ %   \citeyear{key} ==&gt;&gt;             1990
+ %---------------------------------------------------------------------
+
+ENTRY
+  { address
+    author
+    booktitle
+    chapter
+    edition
+    editor
+    howpublished
+    institution
+    journal
+    doi
+    key
+    month
+    note
+    number
+    organization
+    pages
+    publisher
+    school
+    series
+    title
+    type
+    url
+    volume
+    year
+  }
+  {}
+  { label extra.label sort.label short.list }
+
+INTEGERS { output.state before.all mid.sentence after.sentence after.block }
+
+FUNCTION {init.state.consts}
+{ #0 'before.all :=
+  #1 'mid.sentence :=
+  #2 'after.sentence :=
+  #3 'after.block :=
+}
+
+STRINGS { s t }
+
+FUNCTION {output.nonnull}
+{ 's :=
+  output.state mid.sentence =
+    { &quot;, &quot; * write$ }
+    { output.state after.block =
+        { add.period$ write$
+          newline$
+          &quot;</font>
<font color="blue">ewblock &quot; write$
+        }
+        { output.state before.all =
+            'write$
+            { add.period$ &quot; &quot; * write$ }
+          if$
+        }
+      if$
+      mid.sentence 'output.state :=
+    }
+  if$
+  s
+}
+
+FUNCTION {output}
+{ duplicate$ empty$
+    'pop$
+    'output.nonnull
+  if$
+}
+
+FUNCTION {output.check}
+{ 't :=
+  duplicate$ empty$
+    { pop$ &quot;empty &quot; t * &quot; in &quot; * cite$ * warning$ }
+    'output.nonnull
+  if$
+}
+
+FUNCTION {fin.entry}
+{ add.period$
+  write$
+  newline$
+}
+
+FUNCTION {new.block}
+{ output.state before.all =
+    'skip$
+    { after.block 'output.state := }
+  if$
+}
+
+FUNCTION {new.sentence}
+{ output.state after.block =
+    'skip$
+    { output.state before.all =
+        'skip$
+        { after.sentence 'output.state := }
+      if$
+    }
+  if$
+}
+
+FUNCTION {add.blank}
+{  &quot; &quot; * before.all 'output.state :=
+}
+
+FUNCTION {add.colon}
+{ duplicate$ empty$
+    'skip$
+    { &quot;:&quot; * add.blank }
+  if$
+}
+
+FUNCTION {date.block}
+{
+  skip$
+}
+
+FUNCTION {not}
+{   { #0 }
+    { #1 }
+  if$
+}
+
+FUNCTION {and}
+{   'skip$
+    { pop$ #0 }
+  if$
+}
+
+FUNCTION {or}
+{   { pop$ #1 }
+    'skip$
+  if$
+}
+
+FUNCTION {new.block.checkb}
+{ empty$
+  swap$ empty$
+  and
+    'skip$
+    'new.block
+  if$
+}
+
+FUNCTION {field.or.null}
+{ duplicate$ empty$
+    { pop$ &quot;&quot; }
+    'skip$
+  if$
+}
+
+FUNCTION {emphasize}
+{ duplicate$ empty$
+    { pop$ &quot;&quot; }
+    { &quot;{\it &quot; swap$ * &quot;\/}&quot; * }
+  if$
+}
+
+FUNCTION {bolden}
+{ duplicate$ empty$
+    { pop$ &quot;&quot; }
+    { &quot;{\bf &quot; swap$ * &quot;}&quot; * }
+  if$
+}
+
+FUNCTION {capitalize}
+{ &quot;u&quot; change.case$ &quot;t&quot; change.case$ }
+
+FUNCTION {space.word}
+{ &quot; &quot; swap$ * &quot; &quot; * }
+
+ % Here are the language-specific definitions for explicit words.
+ % Each function has a name bbl.xxx where xxx is the English word.
+ % The language selected here is ENGLISH
+FUNCTION {bbl.and}
+{ &quot;and&quot;}
+
+FUNCTION {bbl.etal}
+{ &quot;et~al.&quot; }
+
+FUNCTION {bbl.editors}
+{ &quot;eds.&quot; }
+
+FUNCTION {bbl.editor}
+{ &quot;ed.&quot; }
+
+FUNCTION {bbl.edby}
+{ &quot;edited by&quot; }
+
+FUNCTION {bbl.edition}
+{ &quot;edition&quot; }
+
+FUNCTION {bbl.volume}
+{ &quot;volume&quot; }
+
+FUNCTION {bbl.of}
+{ &quot;of&quot; }
+
+FUNCTION {bbl.number}
+{ &quot;number&quot; }
+
+FUNCTION {bbl.nr}
+{ &quot;no.&quot; }
+
+FUNCTION {bbl.in}
+{ &quot;in&quot; }
+
+FUNCTION {bbl.pages}
+{ &quot;pp.&quot; }
+
+FUNCTION {bbl.page}
+{ &quot;p.&quot; }
+
+FUNCTION {bbl.chapter}
+{ &quot;chapter&quot; }
+
+FUNCTION {bbl.techrep}
+{ &quot;Technical Report&quot; }
+
+FUNCTION {bbl.mthesis}
+{ &quot;Master's thesis&quot; }
+
+FUNCTION {bbl.phdthesis}
+{ &quot;Ph.D. thesis&quot; }
+
+MACRO {jan} {&quot;January&quot;}
+
+MACRO {feb} {&quot;February&quot;}
+
+MACRO {mar} {&quot;March&quot;}
+
+MACRO {apr} {&quot;April&quot;}
+
+MACRO {may} {&quot;May&quot;}
+
+MACRO {jun} {&quot;June&quot;}
+
+MACRO {jul} {&quot;July&quot;}
+
+MACRO {aug} {&quot;August&quot;}
+
+MACRO {sep} {&quot;September&quot;}
+
+MACRO {oct} {&quot;October&quot;}
+
+MACRO {nov} {&quot;November&quot;}
+
+MACRO {dec} {&quot;December&quot;}
+
+
+ %-------------------------------------------------------------------
+ % Begin module:
+ % \ProvidesFile{physjour.mbs}[1999/02/24 2.0d (PWD)]
+MACRO {ar} {&quot;Atmos. Res.&quot;}
+
+MACRO {aa}{&quot;Astron. \&amp; Astrophys.&quot;}
+MACRO {aasup}{&quot;Astron. \&amp; Astrophys. Suppl. Ser.&quot;}
+MACRO {aph} {&quot;Acta Phys.&quot;}
+MACRO {advp} {&quot;Adv. Phys.&quot;}
+MACRO {ajp} {&quot;Amer. J. Phys.&quot;}
+MACRO {ajm} {&quot;Amer. J. Math.&quot;}
+MACRO {amsci} {&quot;Amer. Sci.&quot;}
+MACRO {anofd} {&quot;Ann. Fluid Dyn.&quot;}
+MACRO {am} {&quot;Ann. Math.&quot;}
+MACRO {ap} {&quot;Ann. Phys. (NY)&quot;}
+MACRO {adp} {&quot;Ann. Phys. (Leipzig)&quot;}
+MACRO {ao} {&quot;Appl. Opt.&quot;}
+MACRO {apl} {&quot;Appl. Phys. Lett.&quot;}
+MACRO {app} {&quot;Astroparticle Phys.&quot;}
+MACRO {apj} {&quot;Astrophys. J.&quot;}
+MACRO {apjsup} {&quot;Astrophys. J. Suppl. Ser.&quot;}
+MACRO {baps} {&quot;Bull. Amer. Phys. Soc.&quot;}
+MACRO {cmp} {&quot;Comm. Math. Phys.&quot;}
+MACRO {cpam} {&quot;Commun. Pure Appl. Math.&quot;}
+MACRO {cppcf} {&quot;Comm. Plasma Phys. \&amp; Controlled Fusion&quot;}
+MACRO {cpc} {&quot;Comp. Phys. Comm.&quot;}
+MACRO {cqg} {&quot;Class. Quant. Grav.&quot;}
+MACRO {cra} {&quot;C. R. Acad. Sci. A&quot;}
+MACRO {fed} {&quot;Fusion Eng. \&amp; Design&quot;}
+MACRO {ft} {&quot;Fusion Tech.&quot;}
+MACRO {grg} {&quot;Gen. Relativ. Gravit.&quot;}
+MACRO {ieeens} {&quot;IEEE Trans. Nucl. Sci.&quot;}
+MACRO {ieeeps} {&quot;IEEE Trans. Plasma Sci.&quot;}
+MACRO {ijimw} {&quot;Interntl. J. Infrared \&amp; Millimeter Waves&quot;}
+MACRO {ip} {&quot;Infrared Phys.&quot;}
+MACRO {irp} {&quot;Infrared Phys.&quot;}
+MACRO {jap} {&quot;J. Appl. Phys.&quot;}
+MACRO {jasa} {&quot;J. Acoust. Soc. America&quot;}
+MACRO {jcp} {&quot;J. Comp. Phys.&quot;}
+MACRO {jetp} {&quot;Sov. Phys.--JETP&quot;}
+MACRO {jfe} {&quot;J. Fusion Energy&quot;}
+MACRO {jfm} {&quot;J. Fluid Mech.&quot;}
+MACRO {jmp} {&quot;J. Math. Phys.&quot;}
+MACRO {jne} {&quot;J. Nucl. Energy&quot;}
+MACRO {jnec} {&quot;J. Nucl. Energy, C: Plasma Phys., Accelerators, Thermonucl. Res.&quot;}
+MACRO {jnm} {&quot;J. Nucl. Mat.&quot;}
+MACRO {jpc} {&quot;J. Phys. Chem.&quot;}
+MACRO {jpp} {&quot;J. Plasma Phys.&quot;}
+MACRO {jpsj} {&quot;J. Phys. Soc. Japan&quot;}
+MACRO {jsi} {&quot;J. Sci. Instrum.&quot;}
+MACRO {jvst} {&quot;J. Vac. Sci. \&amp; Tech.&quot;}
+MACRO {nat} {&quot;Nature&quot;}
+MACRO {nature} {&quot;Nature&quot;}
+MACRO {nedf} {&quot;Nucl. Eng. \&amp; Design/Fusion&quot;}
+MACRO {nf} {&quot;Nucl. Fusion&quot;}
+MACRO {nim} {&quot;Nucl. Inst. \&amp; Meth.&quot;}
+MACRO {nimpr} {&quot;Nucl. Inst. \&amp; Meth. in Phys. Res.&quot;}
+MACRO {np} {&quot;Nucl. Phys.&quot;}
+MACRO {npb} {&quot;Nucl. Phys. B&quot;}
+MACRO {nt/f} {&quot;Nucl. Tech./Fusion&quot;}
+MACRO {npbpc} {&quot;Nucl. Phys. B (Proc. Suppl.)&quot;}
+MACRO {inc} {&quot;Nuovo Cimento&quot;}
+MACRO {nc} {&quot;Nuovo Cimento&quot;}
+MACRO {pf} {&quot;Phys. Fluids&quot;}
+MACRO {pfa} {&quot;Phys. Fluids A: Fluid Dyn.&quot;}
+MACRO {pfb} {&quot;Phys. Fluids B: Plasma Phys.&quot;}
+MACRO {pl} {&quot;Phys. Lett.&quot;}
+MACRO {pla} {&quot;Phys. Lett. A&quot;}
+MACRO {plb} {&quot;Phys. Lett. B&quot;}
+MACRO {prep} {&quot;Phys. Rep.&quot;}
+MACRO {pnas} {&quot;Proc. Nat. Acad. Sci. USA&quot;}
+MACRO {pp} {&quot;Phys. Plasmas&quot;}
+MACRO {ppcf} {&quot;Plasma Phys. \&amp; Controlled Fusion&quot;}
+MACRO {phitrsl} {&quot;Philos. Trans. Roy. Soc. London&quot;}
+MACRO {prl} {&quot;Phys. Rev. Lett.&quot;}
+MACRO {pr} {&quot;Phys. Rev.&quot;}
+MACRO {physrev} {&quot;Phys. Rev.&quot;}
+MACRO {pra} {&quot;Phys. Rev. A&quot;}
+MACRO {prb} {&quot;Phys. Rev. B&quot;}
+MACRO {prc} {&quot;Phys. Rev. C&quot;}
+MACRO {prd} {&quot;Phys. Rev. D&quot;}
+MACRO {pre} {&quot;Phys. Rev. E&quot;}
+MACRO {ps} {&quot;Phys. Scripta&quot;}
+MACRO {procrsl} {&quot;Proc. Roy. Soc. London&quot;}
+MACRO {rmp} {&quot;Rev. Mod. Phys.&quot;}
+MACRO {rsi} {&quot;Rev. Sci. Inst.&quot;}
+MACRO {science} {&quot;Science&quot;}
+MACRO {sciam} {&quot;Sci. Am.&quot;}
+MACRO {sam} {&quot;Stud. Appl. Math.&quot;}
+MACRO {sjpp} {&quot;Sov. J. Plasma Phys.&quot;}
+MACRO {spd} {&quot;Sov. Phys.--Doklady&quot;}
+MACRO {sptp} {&quot;Sov. Phys.--Tech. Phys.&quot;}
+MACRO {spu} {&quot;Sov. Phys.--Uspeki&quot;}
+ % End module: physjour.mbs
+ %-------------------------------------------------------------------
+ % Begin module:
+ % \ProvidesFile{geojour.mbs}[1999/02/24 2.0e (PWD)]
+MACRO {aisr} {&quot;Adv. Space Res.&quot;}
+MACRO {ag} {&quot;Ann. Geophys.&quot;}
+MACRO {anigeo} {&quot;Ann. Geofis.&quot;}
+MACRO {angl} {&quot;Ann. Glaciol.&quot;}
+MACRO {andmet} {&quot;Ann. d. Meteor.&quot;}
+MACRO {andgeo} {&quot;Ann. d. Geophys.&quot;}
+MACRO {andphy} {&quot;Ann. d. Phys.&quot;}
+MACRO {afmgb} {&quot;Arch. Meteor. Geophys. Bioklimatol.&quot;}
+MACRO {atph} {&quot;Atm\'osphera&quot;}
+MACRO {aao} {&quot;Atmos.-Ocean&quot;}
+MACRO {ass}{&quot;Astrophys. Space Sci.&quot;}
+MACRO {atenv} {&quot;Atmos. Environ.&quot;}
+MACRO {aujag} {&quot;Aust. J. Agric. Res.&quot;}
+MACRO {aumet} {&quot;Aust. Meteor. Mag.&quot;}
+MACRO {blmet} {&quot;Bound.-Layer Meteor.&quot;}
+MACRO {bams} {&quot;Bull. Amer. Meteor. Soc.&quot;}
+MACRO {cch} {&quot;Clim. Change&quot;}
+MACRO {cdyn} {&quot;Climate Dyn.&quot;}
+MACRO {cbul} {&quot;Climatol. Bull.&quot;}
+MACRO {cap} {&quot;Contrib. Atmos. Phys.&quot;}
+MACRO {dsr} {&quot;Deep-Sea Res.&quot;}
+MACRO {dhz} {&quot;Dtsch. Hydrogr. Z.&quot;}
+MACRO {dao} {&quot;Dyn. Atmos. Oceans&quot;}
+MACRO {eco} {&quot;Ecology&quot;}
+MACRO {empl}{&quot;Earth, Moon and Planets&quot;}
+MACRO {envres} {&quot;Environ. Res.&quot;}
+MACRO {envst} {&quot;Environ. Sci. Technol.&quot;}
+MACRO {ecms} {&quot;Estuarine Coastal Mar. Sci.&quot;}
+MACRO {expa}{&quot;Exper. Astron.&quot;}
+MACRO {geoint} {&quot;Geofis. Int.&quot;}
+MACRO {geopub} {&quot;Geofys. Publ.&quot;}
+MACRO {geogeo} {&quot;Geol. Geofiz.&quot;}
+MACRO {gafd} {&quot;Geophys. Astrophys. Fluid Dyn.&quot;}
+MACRO {gfd} {&quot;Geophys. Fluid Dyn.&quot;}
+MACRO {geomag} {&quot;Geophys. Mag.&quot;}
+MACRO {georl} {&quot;Geophys. Res. Lett.&quot;}
+MACRO {grl} {&quot;Geophys. Res. Lett.&quot;}
+MACRO {ga} {&quot;Geophysica&quot;}
+MACRO {gs} {&quot;Geophysics&quot;}
+MACRO {ieeetap} {&quot;IEEE Trans. Antennas Propag.&quot;}
+MACRO {ijawp} {&quot;Int. J. Air Water Pollut.&quot;}
+MACRO {ijc} {&quot;Int. J. Climatol.&quot;}
+MACRO {ijrs} {&quot;Int. J. Remote Sensing&quot;}
+MACRO {jam} {&quot;J. Appl. Meteor.&quot;}
+MACRO {jaot} {&quot;J. Atmos. Ocean. Technol.&quot;}
+MACRO {jatp} {&quot;J. Atmos. Terr. Phys.&quot;}
+MACRO {jce} {&quot;J. Climate&quot;}
+MACRO {jcam} {&quot;J. Climate Appl. Meteor.&quot;}
+MACRO {jcm} {&quot;J. Climate Meteor.&quot;}
+MACRO {jcy} {&quot;J. Climatol.&quot;}
+MACRO {jgr} {&quot;J. Geophys. Res.&quot;}
+MACRO {jga} {&quot;J. Glaciol.&quot;}
+MACRO {jh} {&quot;J. Hydrol.&quot;}
+MACRO {jmr} {&quot;J. Mar. Res.&quot;}
+MACRO {jmrj} {&quot;J. Meteor. Res. Japan&quot;}
+MACRO {jm} {&quot;J. Meteor.&quot;}
+MACRO {jpo} {&quot;J. Phys. Oceanogr.&quot;}
+MACRO {jra} {&quot;J. Rech. Atmos.&quot;}
+MACRO {jaes} {&quot;J. Aeronaut. Sci.&quot;}
+MACRO {japca} {&quot;J. Air Pollut. Control Assoc.&quot;}
+MACRO {jas} {&quot;J. Atmos. Sci.&quot;}
+MACRO {jmts} {&quot;J. Mar. Technol. Soc.&quot;}
+MACRO {jmsj} {&quot;J. Meteor. Soc. Japan&quot;}
+MACRO {josj} {&quot;J. Oceanogr. Soc. Japan&quot;}
+MACRO {jwm} {&quot;J. Wea. Mod.&quot;}
+MACRO {lao} {&quot;Limnol. Oceanogr.&quot;}
+MACRO {mwl} {&quot;Mar. Wea. Log&quot;}
+MACRO {mau} {&quot;Mausam&quot;}
+MACRO {meteor} {&quot;``Meteor'' Forschungsergeb.&quot;}
+MACRO {map} {&quot;Met. Atmos. Phys.&quot;}
+MACRO {metmag} {&quot;Meteor. Mag.&quot;}
+MACRO {metmon} {&quot;Meteor. Monogr.&quot;}
+MACRO {metrun} {&quot;Meteor. Rundsch.&quot;}
+MACRO {metzeit} {&quot;Meteor. Z.&quot;}
+MACRO {metgid} {&quot;Meteor. Gidrol.&quot;}
+MACRO {mwr} {&quot;Mon. Wea. Rev.&quot;}
+MACRO {nwd} {&quot;Natl. Wea. Dig.&quot;}
+MACRO {nzjmfr} {&quot;N. Z. J. Mar. Freshwater Res.&quot;}
+MACRO {npg} {&quot;Nonlin. Proc. Geophys.&quot;}
+MACRO {om} {&quot;Oceanogr. Meteor.&quot;}
+MACRO {ocac} {&quot;Oceanol. Acta&quot;}
+MACRO {oceanus} {&quot;Oceanus&quot;}
+MACRO {paleoc} {&quot;Paleoceanography&quot;}
+MACRO {pce} {&quot;Physics and Chemistry of the Earth&quot;}
+MACRO {pmg} {&quot;Pap. Meteor. Geophys.&quot;}
+MACRO {ppom} {&quot;Pap. Phys. Oceanogr. Meteor.&quot;}
+MACRO {physzeit} {&quot;Phys. Z.&quot;}
+MACRO {pps} {&quot;Planet. Space Sci.&quot;}
+MACRO {pss} {&quot;Planet. Space Sci.&quot;}
+MACRO {pag} {&quot;Pure Appl. Geophys.&quot;}
+MACRO {qjrms} {&quot;Quart. J. Roy. Meteor. Soc.&quot;}
+MACRO {quatres} {&quot;Quat. Res.&quot;}
+MACRO {rsci} {&quot;Radio Sci.&quot;}
+MACRO {rse} {&quot;Remote Sens. Environ.&quot;}
+MACRO {rgeo} {&quot;Rev. Geophys.&quot;}
+MACRO {rgsp} {&quot;Rev. Geophys. Space Phys.&quot;}
+MACRO {rdgeo} {&quot;Rev. Geofis.&quot;}
+MACRO {revmeta} {&quot;Rev. Meteor.&quot;}
+MACRO {sgp}{&quot;Surveys in Geophys.&quot;}
+MACRO {sp} {&quot;Solar Phys.&quot;}
+MACRO {ssr} {&quot;Space Sci. Rev.&quot;}
+MACRO {tellus} {&quot;Tellus&quot;}
+MACRO {tac} {&quot;Theor. Appl. Climatol.&quot;}
+MACRO {tagu} {&quot;Trans. Am. Geophys. Union (EOS)&quot;}
+MACRO {wrr} {&quot;Water Resour. Res.&quot;}
+MACRO {weather} {&quot;Weather&quot;}
+MACRO {wafc} {&quot;Wea. Forecasting&quot;}
+MACRO {ww} {&quot;Weatherwise&quot;}
+MACRO {wmob} {&quot;WMO Bull.&quot;}
+MACRO {zeitmet} {&quot;Z. Meteor.&quot;}
+ % End module: geojour.mbs
+%% Copyright 1994-1999 Patrick W Daly
+
+MACRO {acmcs} {&quot;ACM Comput. Surv.&quot;}
+
+MACRO {acta} {&quot;Acta Inf.&quot;}
+
+MACRO {cacm} {&quot;Commun. ACM&quot;}
+
+MACRO {ibmjrd} {&quot;IBM J. Res. Dev.&quot;}
+
+MACRO {ibmsj} {&quot;IBM Syst.~J.&quot;}
+
+MACRO {ieeese} {&quot;IEEE Trans. Softw. Eng.&quot;}
+
+MACRO {ieeetc} {&quot;IEEE Trans. Comput.&quot;}
+
+MACRO {ieeetcad}
+ {&quot;IEEE Trans. Comput.-Aided Design Integrated Circuits&quot;}
+
+MACRO {ipl} {&quot;Inf. Process. Lett.&quot;}
+
+MACRO {jacm} {&quot;J.~ACM&quot;}
+
+MACRO {jcss} {&quot;J.~Comput. Syst. Sci.&quot;}
+
+MACRO {scp} {&quot;Sci. Comput. Programming&quot;}
+
+MACRO {sicomp} {&quot;SIAM J. Comput.&quot;}
+
+MACRO {tocs} {&quot;ACM Trans. Comput. Syst.&quot;}
+
+MACRO {tods} {&quot;ACM Trans. Database Syst.&quot;}
+
+MACRO {tog} {&quot;ACM Trans. Gr.&quot;}
+
+MACRO {toms} {&quot;ACM Trans. Math. Softw.&quot;}
+
+MACRO {toois} {&quot;ACM Trans. Office Inf. Syst.&quot;}
+
+MACRO {toplas} {&quot;ACM Trans. Prog. Lang. Syst.&quot;}
+
+MACRO {tcs} {&quot;Theoretical Comput. Sci.&quot;}
+
+FUNCTION {write.url}
+{ url empty$
+    { skip$ }
+    { &quot;</font>
<font color="blue">ewline\urlprefix\url{&quot; url * &quot;}&quot; * write$ newline$ }
+  if$
+}
+
+FUNCTION {format.doi}
+{ doi empty$
+    { &quot;&quot; }
+    { &quot;doi:&quot; doi * }
+  if$
+}
+
+INTEGERS { nameptr namesleft numnames }
+
+FUNCTION {format.names}
+{ 's :=
+  #1 'nameptr :=
+  s num.names$ 'numnames :=
+  numnames 'namesleft :=
+    { namesleft #0 &gt; }
+    { nameptr #1 &gt;
+        { s nameptr &quot;{f.~}{vv~}{ll}{, jj}&quot; format.name$  }
+        { s nameptr &quot;{vv~}{ll}{, f.}{, jj}&quot; format.name$  }
+      if$
+    't :=
+      nameptr #1 &gt;
+        {
+          namesleft #1 &gt;
+            { &quot;, &quot; * t * }
+            {
+              numnames #2 &gt;
+                { &quot;,&quot; * }
+                'skip$
+              if$
+              s nameptr &quot;{ll}&quot; format.name$ duplicate$ &quot;others&quot; =
+                { 't := }
+                { pop$ }
+              if$
+              t &quot;others&quot; =
+                {
+                  &quot; &quot; * bbl.etal *
+                }
+                { bbl.and
+                  space.word * t *
+                }
+              if$
+            }
+          if$
+        }
+        't
+      if$
+      nameptr #1 + 'nameptr :=
+      namesleft #1 - 'namesleft :=
+    }
+  while$
+}
+FUNCTION {format.names.ed}
+{ 's :=
+  #1 'nameptr :=
+  s num.names$ 'numnames :=
+  numnames 'namesleft :=
+    { namesleft #0 &gt; }
+    { s nameptr
+      &quot;{f.~}{vv~}{ll}{, jj}&quot;
+      format.name$
+      't :=
+      nameptr #1 &gt;
+        {
+          namesleft #1 &gt;
+            { &quot;, &quot; * t * }
+            {
+              numnames #2 &gt;
+                { &quot;,&quot; * }
+                'skip$
+              if$
+              s nameptr &quot;{ll}&quot; format.name$ duplicate$ &quot;others&quot; =
+                { 't := }
+                { pop$ }
+              if$
+              t &quot;others&quot; =
+                {
+
+                  &quot; &quot; * bbl.etal *
+                }
+                { bbl.and
+                  space.word * t *
+                }
+              if$
+            }
+          if$
+        }
+        't
+      if$
+      nameptr #1 + 'nameptr :=
+      namesleft #1 - 'namesleft :=
+    }
+  while$
+}
+
+FUNCTION {format.key}
+{ empty$
+    { key field.or.null }
+    { &quot;&quot; }
+  if$
+}
+
+FUNCTION {format.authors}
+{ author empty$
+    { &quot;&quot; }
+    { author format.names }
+  if$
+}
+
+FUNCTION {format.editors}
+{ editor empty$
+    { &quot;&quot; }
+    { editor format.names
+      editor num.names$ #1 &gt;
+        { &quot;, &quot; * bbl.editors * }
+        { &quot;, &quot; * bbl.editor * }
+      if$
+    }
+  if$
+}
+
+FUNCTION {format.in.editors}
+{ editor empty$
+    { &quot;&quot; }
+    { editor format.names.ed
+    }
+  if$
+}
+
+FUNCTION {format.book.pages}
+{ pages empty$
+    { &quot;&quot; }
+    { pages &quot; &quot; * bbl.pages * }
+  if$
+}
+
+FUNCTION {format.note}
+{
+ note empty$
+    { &quot;&quot; }
+    { note #1 #1 substring$
+      duplicate$ &quot;{&quot; =
+        'skip$
+        { output.state mid.sentence =
+          { &quot;l&quot; }
+          { &quot;u&quot; }
+        if$
+        change.case$
+        }
+      if$
+      note #2 global.max$ substring$ *
+    }
+  if$
+}
+
+FUNCTION {format.title}
+{ title empty$
+    { &quot;&quot; }
+    { title &quot;t&quot; change.case$
+    }
+  if$
+}
+
+FUNCTION {format.full.names}
+{'s :=
+  #1 'nameptr :=
+  s num.names$ 'numnames :=
+  numnames 'namesleft :=
+    { namesleft #0 &gt; }
+    { s nameptr
+      &quot;{vv~}{ll}&quot; format.name$
+      't :=
+      nameptr #1 &gt;
+        {
+          namesleft #1 &gt;
+            { &quot;, &quot; * t * }
+            {
+              numnames #2 &gt;
+                { &quot;,&quot; * }
+                'skip$
+              if$
+              s nameptr &quot;{ll}&quot; format.name$ duplicate$ &quot;others&quot; =
+                { 't := }
+                { pop$ }
+              if$
+              t &quot;others&quot; =
+                {
+                  &quot; &quot; * bbl.etal *
+                }
+                { bbl.and
+                  space.word * t *
+                }
+              if$
+            }
+          if$
+        }
+        't
+      if$
+      nameptr #1 + 'nameptr :=
+      namesleft #1 - 'namesleft :=
+    }
+  while$
+}
+
+FUNCTION {author.editor.key.full}
+{ author empty$
+    { editor empty$
+        { key empty$
+            { cite$ #1 #3 substring$ }
+            'key
+          if$
+        }
+        { editor format.full.names }
+      if$
+    }
+    { author format.full.names }
+  if$
+}
+
+FUNCTION {author.key.full}
+{ author empty$
+    { key empty$
+         { cite$ #1 #3 substring$ }
+          'key
+      if$
+    }
+    { author format.full.names }
+  if$
+}
+
+FUNCTION {editor.key.full}
+{ editor empty$
+    { key empty$
+         { cite$ #1 #3 substring$ }
+          'key
+      if$
+    }
+    { editor format.full.names }
+  if$
+}
+
+FUNCTION {make.full.names}
+{ type$ &quot;book&quot; =
+  type$ &quot;inbook&quot; =
+  or
+    'author.editor.key.full
+    { type$ &quot;proceedings&quot; =
+        'editor.key.full
+        'author.key.full
+      if$
+    }
+  if$
+}
+
+FUNCTION {output.bibitem}
+{ newline$
+  &quot;\bibitem[{&quot; write$
+  label write$
+  &quot;)&quot; make.full.names duplicate$ short.list =
+     { pop$ }
+     { * }
+   if$
+  &quot;}]{&quot; * write$
+  cite$ write$
+  &quot;}&quot; write$
+  newline$
+  &quot;&quot;
+  before.all 'output.state :=
+}
+
+FUNCTION {n.dashify}
+{
+  't :=
+  &quot;&quot;
+    { t empty$ not }
+    { t #1 #1 substring$ &quot;-&quot; =
+        { t #1 #2 substring$ &quot;--&quot; = not
+            { &quot;--&quot; *
+              t #2 global.max$ substring$ 't :=
+            }
+            {   { t #1 #1 substring$ &quot;-&quot; = }
+                { &quot;-&quot; *
+                  t #2 global.max$ substring$ 't :=
+                }
+              while$
+            }
+          if$
+        }
+        { t #1 #1 substring$ *
+          t #2 global.max$ substring$ 't :=
+        }
+      if$
+    }
+  while$
+}
+
+FUNCTION {word.in}
+{ &quot;&quot; }
+
+FUNCTION {format.date}
+{ year duplicate$ empty$
+    { &quot;empty year in &quot; cite$ * &quot;; set to ????&quot; * warning$
+       pop$ &quot;????&quot; }
+    'skip$
+  if$
+  extra.label *
+}
+
+FUNCTION {format.btitle}
+{ title emphasize
+}
+
+FUNCTION {tie.or.space.connect}
+{ duplicate$ text.length$ #3 &lt;
+    { &quot;~&quot; }
+    { &quot; &quot; }
+  if$
+  swap$ * *
+}
+
+FUNCTION {either.or.check}
+{ empty$
+    'pop$
+    { &quot;can't use both &quot; swap$ * &quot; fields in &quot; * cite$ * warning$ }
+  if$
+}
+
+FUNCTION {format.bvolume}
+{ volume empty$
+    { &quot;&quot; }
+    { bbl.volume volume tie.or.space.connect
+      series empty$
+        'skip$
+        { bbl.of space.word * series emphasize * }
+      if$
+      &quot;volume and number&quot; number either.or.check
+    }
+  if$
+}
+
+FUNCTION {format.number.series}
+{ volume empty$
+    { number empty$
+        { series field.or.null }
+        { output.state mid.sentence =
+            { bbl.number }
+            { bbl.number capitalize }
+          if$
+          number tie.or.space.connect
+          series empty$
+            { &quot;there's a number but no series in &quot; cite$ * warning$ }
+            { bbl.in space.word * series * }
+          if$
+        }
+      if$
+    }
+    { &quot;&quot; }
+  if$
+}
+
+
+FUNCTION {format.edition}
+{ edition empty$
+    { &quot;&quot; }
+    { output.state mid.sentence =
+        { edition &quot;l&quot; change.case$ &quot; &quot; * bbl.edition * }
+        { edition &quot;t&quot; change.case$ &quot; &quot; * bbl.edition * }
+      if$
+    }
+  if$
+}
+
+INTEGERS { multiresult }
+
+FUNCTION {multi.page.check}
+{ 't :=
+  #0 'multiresult :=
+    { multiresult not
+      t empty$ not
+      and
+    }
+    { t #1 #1 substring$
+      duplicate$ &quot;-&quot; =
+      swap$ duplicate$ &quot;,&quot; =
+      swap$ &quot;+&quot; =
+      or or
+        { #1 'multiresult := }
+        { t #2 global.max$ substring$ 't := }
+      if$
+    }
+  while$
+  multiresult
+}
+
+FUNCTION {format.pages}
+{ pages empty$
+    { &quot;&quot; }
+    { pages multi.page.check
+        { pages n.dashify }
+        { pages }
+      if$
+    }
+  if$
+}
+
+FUNCTION {format.journal.pages}
+{ pages empty$
+    'skip$
+    { duplicate$ empty$
+        { pop$ format.pages }
+        {
+          &quot;, &quot; *
+          pages n.dashify *
+        }
+      if$
+    }
+  if$
+}
+
+FUNCTION {format.vol.num.pages}
+{ volume field.or.null
+  bolden
+}
+
+FUNCTION {format.chapter.pages}
+{ chapter empty$
+    { &quot;&quot; }
+    { type empty$
+        { bbl.chapter }
+        { type &quot;l&quot; change.case$ }
+      if$
+      chapter tie.or.space.connect
+    }
+  if$
+}
+
+FUNCTION {format.in.ed.booktitle}
+{ booktitle empty$
+    { &quot;&quot; }
+    { editor empty$
+        { word.in booktitle emphasize * }
+        { word.in booktitle emphasize *
+          &quot;, &quot; *
+          format.in.editors *
+          &quot;, &quot; *
+          editor num.names$ #1 &gt;
+            { bbl.editors }
+            { bbl.editor }
+          if$
+          *
+        }
+      if$
+    }
+  if$
+}
+
+FUNCTION {format.thesis.type}
+{ type empty$
+    'skip$
+    { pop$
+      type &quot;t&quot; change.case$
+    }
+  if$
+}
+
+FUNCTION {format.tr.number}
+{ type empty$
+    { bbl.techrep }
+    'type
+  if$
+  number empty$
+    { &quot;t&quot; change.case$ }
+    { number tie.or.space.connect }
+  if$
+}
+
+FUNCTION {format.article.crossref}
+{
+  word.in
+  &quot; \cite{&quot; * crossref * &quot;}&quot; *
+}
+
+FUNCTION {format.book.crossref}
+{ volume empty$
+    { &quot;empty volume in &quot; cite$ * &quot;'s crossref of &quot; * crossref * warning$
+      word.in
+    }
+    { bbl.volume capitalize
+      volume tie.or.space.connect
+      bbl.of space.word *
+    }
+  if$
+  &quot; \cite{&quot; * crossref * &quot;}&quot; *
+}
+
+FUNCTION {format.incoll.inproc.crossref}
+{
+  word.in
+  &quot; \cite{&quot; * crossref * &quot;}&quot; *
+}
+
+FUNCTION {format.org.or.pub}
+{ 't :=
+  &quot;&quot;
+  address empty$ t empty$ and
+    'skip$
+    {
+      t empty$
+        { address empty$
+          'skip$
+          { address * }
+          if$
+        }
+        { t *
+          address empty$
+            'skip$
+            { &quot;, &quot; * address * }
+          if$
+        }
+      if$
+    }
+  if$
+}
+
+FUNCTION {format.publisher.address}
+{ publisher empty$
+    { &quot;empty publisher in &quot; cite$ * warning$
+      &quot;&quot;
+    }
+    { publisher }
+  if$
+  format.org.or.pub
+}
+
+FUNCTION {format.organization.address}
+{ organization empty$
+    { &quot;&quot; }
+    { organization }
+  if$
+  format.org.or.pub
+}
+
+STRINGS {oldname}
+
+FUNCTION {name.or.dash}
+{ 's :=
+   oldname empty$
+     { s 'oldname := s }
+     { s oldname =
+         { &quot;---&quot; add.blank }
+         { s 'oldname := s }
+       if$
+     }
+   if$
+}
+
+FUNCTION {article}
+{ output.bibitem
+  format.authors &quot;author&quot; output.check
+  author format.key output
+  name.or.dash
+  format.date &quot;year&quot; output.check
+  add.colon
+  date.block
+  format.title &quot;title&quot; output.check
+  new.sentence
+  crossref missing$
+    { journal
+      emphasize
+      &quot;journal&quot; output.check
+      format.vol.num.pages output
+    }
+    { format.article.crossref output.nonnull
+      format.pages output
+    }
+  if$
+  format.journal.pages
+  format.doi output
+  format.note output
+  fin.entry
+  write.url
+}
+
+FUNCTION {book}
+{ output.bibitem
+  author empty$
+    { format.editors &quot;author and editor&quot; output.check
+      editor format.key output
+      name.or.dash
+    }
+    { format.authors output.nonnull
+      name.or.dash
+      crossref missing$
+        { &quot;author and editor&quot; editor either.or.check }
+        'skip$
+      if$
+    }
+  if$
+  format.date &quot;year&quot; output.check
+  add.colon
+  date.block
+  format.btitle &quot;title&quot; output.check
+  crossref missing$
+    { format.bvolume output
+  new.sentence
+      format.number.series output
+      format.publisher.address output
+    }
+    {
+  new.sentence
+      format.book.crossref output.nonnull
+    }
+  if$
+  format.edition output
+  format.book.pages output
+  format.note output
+  fin.entry
+  write.url
+}
+
+FUNCTION {booklet}
+{ output.bibitem
+  format.authors output
+  author format.key output
+  name.or.dash
+  format.date &quot;year&quot; output.check
+  add.colon
+  date.block
+  format.title &quot;title&quot; output.check
+  new.sentence
+  howpublished output
+  address output
+  format.book.pages output
+  format.note output
+  fin.entry
+  write.url
+}
+
+FUNCTION {inbook}
+{ output.bibitem
+  author empty$
+    { format.editors &quot;author and editor&quot; output.check
+      editor format.key output
+      name.or.dash
+    }
+    { format.authors output.nonnull
+      name.or.dash
+      crossref missing$
+        { &quot;author and editor&quot; editor either.or.check }
+        'skip$
+      if$
+    }
+  if$
+  format.date &quot;year&quot; output.check
+  add.colon
+  date.block
+  format.btitle &quot;title&quot; output.check
+  crossref missing$
+    {
+      format.publisher.address output
+      format.bvolume output
+      format.chapter.pages &quot;chapter and pages&quot; output.check
+  new.sentence
+      format.number.series output
+    }
+    {
+      format.chapter.pages &quot;chapter and pages&quot; output.check
+  new.sentence
+      format.book.crossref output.nonnull
+    }
+  if$
+  format.edition output
+  format.pages &quot;pages&quot; output.check
+  format.note output
+  fin.entry
+  write.url
+}
+
+FUNCTION {incollection}
+{ output.bibitem
+  format.authors &quot;author&quot; output.check
+  author format.key output
+  name.or.dash
+  format.date &quot;year&quot; output.check
+  add.colon
+  date.block
+  format.title &quot;title&quot; output.check
+  new.sentence
+  crossref missing$
+    { format.in.ed.booktitle &quot;booktitle&quot; output.check
+      format.publisher.address output
+      format.bvolume output
+      format.number.series output
+      format.chapter.pages output
+      format.edition output
+    }
+    { format.incoll.inproc.crossref output.nonnull
+      format.chapter.pages output
+    }
+  if$
+  format.pages &quot;pages&quot; output.check
+  format.note output
+  fin.entry
+  write.url
+}
+
+FUNCTION {inproceedings}
+{ output.bibitem
+  format.authors &quot;author&quot; output.check
+  author format.key output
+  name.or.dash
+  format.date &quot;year&quot; output.check
+  add.colon
+  date.block
+  format.title &quot;title&quot; output.check
+  new.sentence
+  crossref missing$
+    { format.in.ed.booktitle &quot;booktitle&quot; output.check
+      publisher empty$
+        { format.organization.address output }
+        { organization output
+          format.publisher.address output
+        }
+      if$
+      format.bvolume output
+      format.number.series output
+      format.pages output
+    }
+    { format.incoll.inproc.crossref output.nonnull
+      format.pages output
+    }
+  if$
+  format.note output
+  fin.entry
+  write.url
+}
+
+FUNCTION {conference} { inproceedings }
+
+FUNCTION {manual}
+{ output.bibitem
+  format.authors output
+  author format.key output
+  name.or.dash
+  format.date &quot;year&quot; output.check
+  add.colon
+  date.block
+  format.btitle &quot;title&quot; output.check
+  new.sentence
+  organization output
+  address output
+  format.edition output
+  format.note output
+  fin.entry
+  write.url
+}
+
+FUNCTION {mastersthesis}
+{ output.bibitem
+  format.authors &quot;author&quot; output.check
+  author format.key output
+  name.or.dash
+  format.date &quot;year&quot; output.check
+  add.colon
+  date.block
+  format.btitle &quot;title&quot; output.check
+  new.sentence
+  bbl.mthesis format.thesis.type output.nonnull
+  school &quot;school&quot; output.check
+  address output
+  format.book.pages output
+  format.note output
+  fin.entry
+  write.url
+}
+
+FUNCTION {misc}
+{ output.bibitem
+  format.authors output
+  author format.key output
+  name.or.dash
+  format.date &quot;year&quot; output.check
+  add.colon
+  date.block
+  format.title output
+  new.sentence
+  howpublished output
+  format.note output
+  fin.entry
+  write.url
+}
+
+FUNCTION {phdthesis}
+{ output.bibitem
+  format.authors &quot;author&quot; output.check
+  author format.key output
+  name.or.dash
+  format.date &quot;year&quot; output.check
+  add.colon
+  date.block
+  format.btitle &quot;title&quot; output.check
+  new.sentence
+  bbl.phdthesis format.thesis.type output.nonnull
+  school &quot;school&quot; output.check
+  address output
+  format.book.pages output
+  format.note output
+  fin.entry
+  write.url
+}
+
+FUNCTION {proceedings}
+{ output.bibitem
+  format.editors output
+  editor format.key output
+  name.or.dash
+  format.date &quot;year&quot; output.check
+  add.colon
+  date.block
+  format.btitle &quot;title&quot; output.check
+  format.bvolume output
+  format.number.series output
+  publisher empty$
+    { format.organization.address output }
+    { organization output
+      format.publisher.address output
+    }
+  if$
+  format.note output
+  fin.entry
+  write.url
+}
+
+FUNCTION {techreport}
+{ output.bibitem
+  format.authors &quot;author&quot; output.check
+  author format.key output
+  name.or.dash
+  format.date &quot;year&quot; output.check
+  add.colon
+  date.block
+  format.title &quot;title&quot; output.check
+  new.sentence
+  format.tr.number output.nonnull
+  institution &quot;institution&quot; output.check
+  address output
+  format.note output
+  fin.entry
+  write.url
+}
+
+FUNCTION {unpublished}
+{ output.bibitem
+  format.authors &quot;author&quot; output.check
+  author format.key output
+  name.or.dash
+  format.date &quot;year&quot; output.check
+  add.colon
+  date.block
+  format.title &quot;title&quot; output.check
+  format.note &quot;note&quot; output.check
+  fin.entry
+  write.url
+}
+
+FUNCTION {default.type} { misc }
+
+READ
+
+FUNCTION {sortify}
+{ purify$
+  &quot;l&quot; change.case$
+}
+
+INTEGERS { len }
+
+FUNCTION {chop.word}
+{ 's :=
+  'len :=
+  s #1 len substring$ =
+    { s len #1 + global.max$ substring$ }
+    's
+  if$
+}
+
+FUNCTION {format.lab.names}
+{ 's :=
+  s #1 &quot;{vv~}{ll}&quot; format.name$
+  s num.names$ duplicate$
+  #2 &gt;
+    { pop$
+      &quot; &quot; * bbl.etal *
+    }
+    { #2 &lt;
+        'skip$
+        { s #2 &quot;{ff }{vv }{ll}{ jj}&quot; format.name$ &quot;others&quot; =
+            {
+              &quot; &quot; * bbl.etal *
+            }
+            { bbl.and space.word * s #2 &quot;{vv~}{ll}&quot; format.name$
+              * }
+          if$
+        }
+      if$
+    }
+  if$
+}
+
+FUNCTION {author.key.label}
+{ author empty$
+    { key empty$
+        { cite$ #1 #3 substring$ }
+        'key
+      if$
+    }
+    { author format.lab.names }
+  if$
+}
+
+FUNCTION {author.editor.key.label}
+{ author empty$
+    { editor empty$
+        { key empty$
+            { cite$ #1 #3 substring$ }
+            'key
+          if$
+        }
+        { editor format.lab.names }
+      if$
+    }
+    { author format.lab.names }
+  if$
+}
+
+FUNCTION {editor.key.label}
+{ editor empty$
+    { key empty$
+        { cite$ #1 #3 substring$ }
+        'key
+      if$
+    }
+    { editor format.lab.names }
+  if$
+}
+
+FUNCTION {calc.short.authors}
+{ type$ &quot;book&quot; =
+  type$ &quot;inbook&quot; =
+  or
+    'author.editor.key.label
+    { type$ &quot;proceedings&quot; =
+        'editor.key.label
+        'author.key.label
+      if$
+    }
+  if$
+  'short.list :=
+}
+
+FUNCTION {calc.label}
+{ calc.short.authors
+  short.list
+  &quot;(&quot;
+  *
+  year duplicate$ empty$
+     { pop$ &quot;????&quot; }
+     'skip$
+  if$
+  *
+  'label :=
+}
+
+FUNCTION {sort.format.names}
+{ 's :=
+  #1 'nameptr :=
+  &quot;&quot;
+  s num.names$ 'numnames :=
+  numnames 'namesleft :=
+    { namesleft #0 &gt; }
+    { s nameptr
+      &quot;{vv{ } }{ll{ }}{  f{ }}{  jj{ }}&quot;
+      format.name$ 't :=
+      nameptr #1 &gt;
+        {
+          &quot;   &quot;  *
+          namesleft #1 = t &quot;others&quot; = and
+            { &quot;zzzzz&quot; * }
+            { t sortify * }
+          if$
+        }
+        { t sortify * }
+      if$
+      nameptr #1 + 'nameptr :=
+      namesleft #1 - 'namesleft :=
+    }
+  while$
+}
+
+FUNCTION {sort.format.title}
+{ 't :=
+  &quot;A &quot; #2
+    &quot;An &quot; #3
+      &quot;The &quot; #4 t chop.word
+    chop.word
+  chop.word
+  sortify
+  #1 global.max$ substring$
+}
+
+FUNCTION {author.sort}
+{ author empty$
+    { key empty$
+        { &quot;to sort, need author or key in &quot; cite$ * warning$
+          &quot;&quot;
+        }
+        { key sortify }
+      if$
+    }
+    { author sort.format.names }
+  if$
+}
+
+FUNCTION {author.editor.sort}
+{ author empty$
+    { editor empty$
+        { key empty$
+            { &quot;to sort, need author, editor, or key in &quot; cite$ * warning$
+              &quot;&quot;
+            }
+            { key sortify }
+          if$
+        }
+        { editor sort.format.names }
+      if$
+    }
+    { author sort.format.names }
+  if$
+}
+
+FUNCTION {editor.sort}
+{ editor empty$
+    { key empty$
+        { &quot;to sort, need editor or key in &quot; cite$ * warning$
+          &quot;&quot;
+        }
+        { key sortify }
+      if$
+    }
+    { editor sort.format.names }
+  if$
+}
+
+FUNCTION {presort}
+{ calc.label
+  label sortify
+  &quot;    &quot;
+  *
+  type$ &quot;book&quot; =
+  type$ &quot;inbook&quot; =
+  or
+    'author.editor.sort
+    { type$ &quot;proceedings&quot; =
+        'editor.sort
+        'author.sort
+      if$
+    }
+  if$
+  #1 entry.max$ substring$
+  'sort.label :=
+  sort.label
+  *
+  &quot;    &quot;
+  *
+  title field.or.null
+  sort.format.title
+  *
+  #1 entry.max$ substring$
+  'sort.key$ :=
+}
+
+ITERATE {presort}
+
+SORT
+
+STRINGS { last.label next.extra }
+
+INTEGERS { last.extra.num number.label }
+
+FUNCTION {initialize.extra.label.stuff}
+{ #0 int.to.chr$ 'last.label :=
+  &quot;&quot; 'next.extra :=
+  #0 'last.extra.num :=
+  #0 'number.label :=
+}
+
+FUNCTION {forward.pass}
+{ last.label label =
+    { last.extra.num #1 + 'last.extra.num :=
+      last.extra.num int.to.chr$ 'extra.label :=
+    }
+    { &quot;a&quot; chr.to.int$ 'last.extra.num :=
+      &quot;&quot; 'extra.label :=
+      label 'last.label :=
+    }
+  if$
+  number.label #1 + 'number.label :=
+}
+
+FUNCTION {reverse.pass}
+{ next.extra &quot;b&quot; =
+    { &quot;a&quot; 'extra.label := }
+    'skip$
+  if$
+  extra.label 'next.extra :=
+  extra.label
+  duplicate$ empty$
+    'skip$
+    { &quot;{</font>
<font color="blue">atexlab{&quot; swap$ * &quot;}}&quot; * }
+  if$
+  'extra.label :=
+  label extra.label * 'label :=
+}
+
+EXECUTE {initialize.extra.label.stuff}
+
+ITERATE {forward.pass}
+
+REVERSE {reverse.pass}
+
+FUNCTION {bib.sort.order}
+{ sort.label
+  &quot;    &quot;
+  *
+  year field.or.null sortify
+  *
+  &quot;    &quot;
+  *
+  title field.or.null
+  sort.format.title
+  *
+  #1 entry.max$ substring$
+  'sort.key$ :=
+}
+
+ITERATE {bib.sort.order}
+
+SORT
+
+FUNCTION {begin.bib}
+{ preamble$ empty$
+    'skip$
+    { preamble$ write$ newline$ }
+  if$
+  &quot;\begin{thebibliography}{&quot; number.label int.to.str$ * &quot;}&quot; *
+  write$ newline$
+  &quot;\expandafter\ifx\csname natexlab\endcsname\relax\def</font>
<font color="gray">atexlab#1{#1}\fi&quot;
+  write$ newline$
+  &quot;\expandafter\ifx\csname url\endcsname\relax&quot;
+  write$ newline$
+  &quot;  \def\url#1{{\tt #1}}\fi&quot;
+  write$ newline$
+  &quot;\expandafter\ifx\csname urlprefix\endcsname\relax\def\urlprefix{URL }\fi&quot;
+  write$ newline$
+  &quot;\expandafter\ifx\csname doiprefix\endcsname\relax\def\doiprefix{doi:}\fi&quot;
+  write$ newline$
+}
+
+EXECUTE {begin.bib}
+
+EXECUTE {init.state.consts}
+
+ITERATE {call.type$}
+
+FUNCTION {end.bib}
+{ newline$
+  &quot;\end{thebibliography}&quot; write$ newline$
+}
+
+EXECUTE {end.bib}
+%% End of customized bst file
+%%
+%% End of file `ametsoc.bst'.

Added: trunk/documents/users_guide/shared/mpas_shared.bib
===================================================================
--- trunk/documents/users_guide/shared/mpas_shared.bib                                (rev 0)
+++ trunk/documents/users_guide/shared/mpas_shared.bib        2013-03-07 17:55:03 UTC (rev 2553)
@@ -0,0 +1,112 @@
+mpas shared bibliography file
+
+These references should apply to all mpas cores.
+
+%%%%%%%% mpas grid %%%%%%%%%
+
+@ARTICLE{Thurburn_ea09jcp,
+   author = {{Thuburn}, J. and {Ringler}, T.~D. and {Skamarock}, W.~C. and 
+        {Klemp}, J.~B.},
+    title = &quot;{Numerical representation of geostrophic modes on arbitrarily structured C-grids}&quot;,
+  journal = {Journal of Computational Physics},
+     year = 2009,
+    month = dec,
+   volume = 228,
+    pages = {8321-8335},
+      doi = {10.1016/j.jcp.2009.08.006},
+   adsurl = {http://adsabs.harvard.edu/abs/2009JCoPh.228.8321T},
+  adsnote = {Provided by the SAO/NASA Astrophysics Data System}
+}
+
+@ARTICLE{Ringler_ea10jcp,
+   author = {{Ringler}, T.~D. and {Thuburn}, J. and {Klemp}, J.~B. and {Skamarock}, W.~C.
+        },
+    title = &quot;{A unified approach to energy conservation and potential vorticity dynamics for arbitrarily-structured C-grids}&quot;,
+  journal = {J. Comp. Physics},
+     year = 2010,
+    month = may,
+   volume = 229,
+    pages = {3065-3090},
+      doi = {10.1016/j.jcp.2009.12.007},
+   adsurl = {http://adsabs.harvard.edu/abs/2010JCoPh.229.3065R},
+  adsnote = {Provided by the SAO/NASA Astrophysics Data System}
+}
+
+@ARTICLE{Ringler_ea08od,
+   author = {{Ringler}, T. and {Ju}, L. and {Gunzburger}, M.},
+    title = &quot;{A multiresolution method for climate system modeling: application of spherical centroidal Voronoi tessellations}&quot;,
+  journal = {Ocean Dynamics},
+ keywords = {Voronoi diagram, Delaunay triangulation, Climate modeling, Multiresolution},
+     year = 2008,
+    month = dec,
+   volume = 58,
+    pages = {475-498},
+      doi = {10.1007/s10236-008-0157-2},
+   adsurl = {http://adsabs.harvard.edu/abs/2008OcDyn..58..475R},
+  adsnote = {Provided by the SAO/NASA Astrophysics Data System}
+}
+
+@article{Du:1999un,
+author = {Du, Q and Gunzburger, M},
+title = {{Centroidal Voronoi tessellations: applications and algorithms}},
+journal = {SIAM review},
+year = {1999},
+volume = {41},
+number = {4},
+pages = {637--676}
+}
+
+@book{OBSC2000,
+author = {Okabe, A and Boots, B and Sugihara, K and Chiu, S},
+title = {{Spatial Tessellations: Concepts and Applications of Voronoi Diagrams}},
+publisher = {Wiley},
+year = {2009}
+}
+
+@article{Ju:2010vi,
+author = {Ju, L and Ringler, T and Gunzburger, M},
+title = {{Voronoi Tessellations and their Application to Climate and Global Modeling}},
+journal = {Numerical Techniques for Global Atmospheric Models,
+Springer Lecture Notes in Computational Science and Engineering,
+Eds. P. H. Lauritzen, C. Jablonowski, M. A. Taylor and
+R. D. Nair},
+year = {2010},
+pages = {1--30}
+}
+
+@ARTICLE{Ringler_Randall02mwr,
+   author = {{Ringler}, T.~D. and {Randall}, D.~A.},
+    title = &quot;{A Potential Enstrophy and Energy Conserving Numerical Scheme for Solution of the Shallow-Water Equations on a Geodesic Grid}&quot;,
+  journal = {Monthly Weather Review},
+     year = 2002,
+   volume = 130,
+    pages = {1397-+},
+      doi = {10.1175/1520-0493(2002)130&lt;1397:APEAEC&gt;2.0.CO;2},
+   adsurl = {http://adsabs.harvard.edu/abs/2002MWRv..130.1397R},
+  adsnote = {Provided by the SAO/NASA Astrophysics Data System}
+}
+
+
+%%%%%%%% advection schemes %%%%%%%%%
+
+@ARTICLE{Miura07mwr,
+   author = {{Miura}, H.},
+    title = &quot;{An Upwind-Biased Conservative Advection Scheme for Spherical Hexagonal Pentagonal Grids}&quot;,
+  journal = {Monthly Weather Review},
+     year = 2007,
+   volume = 135,
+    pages = {4038},
+      doi = {10.1175/2007MWR2101.1},
+   adsurl = {http://adsabs.harvard.edu/abs/2007MWRv..135.4038M},
+  adsnote = {Provided by the SAO/NASA Astrophysics Data System}
+}
+
+@article{Skamarock:2011tc,
+author = {Skamarock, W.C. and Gassmann, A.},
+title = {{Conservative Transport Schemes for Spherical Geodesic Grids: High-Order Flux Operators for ODE-Based Time Integration}},
+journal = {Monthly Weather Review},
+year = {2011},
+volume = {139},
+number = {9},
+pages = {2962--2975}
+}

</font>
</pre>