<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 = "{Conservation of energy in viscous systems}",
-   institution = {Los Alamos National Laboratory},
-     year = 2006,
-     month = "June"
-}
-
-
-%%%%%%%% test domains %%%%%%%%%
-
-@ARTICLE{Ilicak_ea12om,
-   author = {{Ilicak}, M. and {Adcroft}, A.~J. and {Griffies}, S.~M. and 
-        {Hallberg}, R.~W.},
-    title = "{Spurious dianeutral mixing and the role of momentum closure}",
-  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 = "{Comparison of entrainment in overflows simulated by z-coordinate, isopycnal and non-hydrostatic models}",
-  journal = {Ocean Modelling},
-     year = 2006,
-   volume = 11,
-    pages = {69-97}}
-
-
-%%%%%%%% horizonal turbulence closures %%%%%%%%%
-
-@article{Gent_McWilliams90jpo,
-author="Peter R. Gent and James C. {McW}illiams",
-title="Isopycnal Mixing in Ocean Circulation Models",
-journal={\jpo},
-year=1990,
-volume=20,
-number=1,
-pages="150-155"}
-
-@article{Gent_ea95jpo,
-author="Peter R. Gent and Jurgen Willebrand and Trevor McDougall and James C. McWilliams",
-title="Parameterizing eddy-induced tracer transports in ocean general circulation models",
-journal={\jpo},
-year=1995,
-volume=25,
-number=25,
-pages="463-474"}
-
-@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 = "{An eddy closure for potential vorticity}",
-  journal = {Ocean Modelling},
-  year = 2011,
-   note="in press"
-}
-
-
-%%%%%%%% vertical mixing %%%%%%%%%
-
-@article{Pacanowski_Philander81jpo,
-title="Parameterization of Vertical Mixing in Numerical Models of Tropical Oceans",
-author="R.C. Pacanowski and S.G.H. Philander",
-journal={\jpo},
-year=1981,
-volume=11,
-number=11,
-pages="1443-1451"}
-
-@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 = "{Rescaled height coordinates for accurate representation of free-surface flows in ocean circulation models}",
-  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 = "{Conservation of properties in a free-surface model}",
-  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 = "{-Coordinate, an Arbitrary Lagrangian-Eulerian coordinate separating high and low frequency motions}",
-  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{\"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 = "{Impact of partial steps and momentum advection schemes in a global ocean circulation model at eddy-permitting resolution}",
-  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 = "{A Two-Level Time-Stepping Method for Layered Ocean Circulation Models}",
-  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 = "{A two-level time-stepping method for layered ocean circulation models: further development and testing}",
-  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 = "{Representation of Topography by Shaved Cells in a Height Coordinate Ocean Model}",
-  journal = {Monthly Weather Review},
-     year = 1997,
-   volume = 125,
-    pages = {2293},
-      doi = {10.1175/1520-0493(1997)125<2293:ROTBSC>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 = "{Transient Response in a Z-Level Ocean Model That Resolves Topography with Partial Cells}",
-  journal = {Monthly Weather Review},
-     year = 1998,
-   volume = 126,
-    pages = {3248},
-      doi = {10.1175/1520-0493(1998)126<3248:TRIAZL>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 = "{Minimal Adjustment of Hydrographic Profiles to Achieve Static Stability}",
-  journal = {Journal of Atmospheric and Oceanic Technology},
-     year = 1995,
-    month = apr,
-   volume = 12,
-    pages = {381},
-      doi = {10.1175/1520-0426(1995)012<0381:MAOHPT>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="A. Iserles",
-title="A first course in the numerical analysis of differential equations",
-year=1996,
-edition="first",
-publisher="Cambridge University Press"}
-
-@book{Kundu_ea12bk,
-author="P. K. Kundu and I. M. Cohen and D. R. Dowling",
-title="Fluid Mechanics",
-year=2012,
-edition="Fifth",
-publisher="Academic Press"}
-
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 = "{Numerical representation of geostrophic modes on arbitrarily structured C-grids}",
-  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 = "{A unified approach to energy conservation and potential vorticity dynamics for arbitrarily-structured C-grids}",
-  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 = "{A multiresolution method for climate system modeling: application of spherical centroidal Voronoi tessellations}",
-  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 = "{A Potential Enstrophy and Energy Conserving Numerical Scheme for Solution of the Shallow-Water Equations on a Geodesic Grid}",
-  journal = {Monthly Weather Review},
-     year = 2002,
-   volume = 130,
-    pages = {1397-+},
-      doi = {10.1175/1520-0493(2002)130<1397:APEAEC>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 = "{An Upwind-Biased Conservative Advection Scheme for Spherical Hexagonal Pentagonal Grids}",
-  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 &  name & grid &  notes  \\
+\hline 
+${\bf D}^u_h$, ${\bf D}^u_v$  & mom. diffusion terms & edge & $h$ horizonal, $v$ vertical\\ 
+$ D^\varphi_h$, $ D^\varphi_v$ & tracer diff. terms & cell & \\ 
+$f$ & Coriolis parameter & vertex \\
+$f_{eos}$ & equation of state & -  \\
+$g$ & grav. acceleration & constant  \\
+$h$ & layer thickness & cell &\\
+${\bf k}$ & vertical unit vector &  \\
+$K$ &  kinetic energy & edge  & $K = \left| {\bf u} \right|^2 / 2$ \\
+$p$ & pressure & cell \\
+$p^s$ & surface pressure & cell \\ 
+$q$ & potential vorticity & vertex & $q=\eta/h$ \\
+$s^{bot}$ & z-location of bottom of layer & cell \\
+$s^{top}$ & z-location of top of layer & cell \\
+$S$ & salinity & cell &  a tracer $\varphi$  \\
+$t$ & time & -  \\
+$u$ & horizontal velocity & edge  & normal component to edge\\
+${\bf u}$ & horizontal velocity   & - \\
+${\bf v}$ & 3D velocity   & - \\
+$w$ & vertical transport & cell  & determined by coord. type \\
+$z$ & vertical coordinate & - & positive upward \\
+$z^{s}$ & sea surface location & 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 &  name & grid & notes  \\
+\hline 
+$\delta$ & horizontal divergence & cell  & $\delta=</font>
<font color="blue">abla\cdot{\bf u}$  \\
+$\zeta$ & sea surface height & cell   \\
+$\eta$ & absolute vorticity & vertex  & $\eta={\bf k} \cdot </font>
<font color="blue">abla \times {\bf u}+f$ \\
+$\Theta$ & potential temperature & cell  & a tracer $\varphi$ \\
+$\kappa_h$, $\kappa_h$ & diffusion & cell \\ 
+$</font>
<font color="black">u_h$, $</font>
<font color="gray">u_v$ & viscosity & edge \\
+$\rho$ & density & cell  \\
+$\rho_0$ & reference density & constant & \\
+$\varphi$ & generic tracer & cell & 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 = "{Conservation of energy in viscous systems}",
+   institution = {Los Alamos National Laboratory},
+     year = 2006,
+     month = "June"
+}
+
+
+%%%%%%%% test domains %%%%%%%%%
+
+@ARTICLE{Ilicak_ea12om,
+   author = {{Ilicak}, M. and {Adcroft}, A.~J. and {Griffies}, S.~M. and 
+        {Hallberg}, R.~W.},
+    title = "{Spurious dianeutral mixing and the role of momentum closure}",
+  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 = "{Comparison of entrainment in overflows simulated by z-coordinate, isopycnal and non-hydrostatic models}",
+  journal = {Ocean Modelling},
+     year = 2006,
+   volume = 11,
+    pages = {69-97}}
+
+
+%%%%%%%% horizonal turbulence closures %%%%%%%%%
+
+@article{Gent_McWilliams90jpo,
+author="Peter R. Gent and James C. {McW}illiams",
+title="Isopycnal Mixing in Ocean Circulation Models",
+journal={\jpo},
+year=1990,
+volume=20,
+number=1,
+pages="150-155"}
+
+@article{Gent_ea95jpo,
+author="Peter R. Gent and Jurgen Willebrand and Trevor McDougall and James C. McWilliams",
+title="Parameterizing eddy-induced tracer transports in ocean general circulation models",
+journal={\jpo},
+year=1995,
+volume=25,
+number=25,
+pages="463-474"}
+
+@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 = "{An eddy closure for potential vorticity}",
+  journal = {Ocean Modelling},
+  year = 2011,
+   note="in press"
+}
+
+
+%%%%%%%% vertical mixing %%%%%%%%%
+
+@article{Pacanowski_Philander81jpo,
+title="Parameterization of Vertical Mixing in Numerical Models of Tropical Oceans",
+author="R.C. Pacanowski and S.G.H. Philander",
+journal={\jpo},
+year=1981,
+volume=11,
+number=11,
+pages="1443-1451"}
+
+@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 = "{Rescaled height coordinates for accurate representation of free-surface flows in ocean circulation models}",
+  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 = "{Conservation of properties in a free-surface model}",
+  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 = "{-Coordinate, an Arbitrary Lagrangian-Eulerian coordinate separating high and low frequency motions}",
+  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{\"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 = "{Impact of partial steps and momentum advection schemes in a global ocean circulation model at eddy-permitting resolution}",
+  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 = "{A Two-Level Time-Stepping Method for Layered Ocean Circulation Models}",
+  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 = "{A two-level time-stepping method for layered ocean circulation models: further development and testing}",
+  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 = "{Representation of Topography by Shaved Cells in a Height Coordinate Ocean Model}",
+  journal = {Monthly Weather Review},
+     year = 1997,
+   volume = 125,
+    pages = {2293},
+      doi = {10.1175/1520-0493(1997)125<2293:ROTBSC>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 = "{Transient Response in a Z-Level Ocean Model That Resolves Topography with Partial Cells}",
+  journal = {Monthly Weather Review},
+     year = 1998,
+   volume = 126,
+    pages = {3248},
+      doi = {10.1175/1520-0493(1998)126<3248:TRIAZL>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 = "{Minimal Adjustment of Hydrographic Profiles to Achieve Static Stability}",
+  journal = {Journal of Atmospheric and Oceanic Technology},
+     year = 1995,
+    month = apr,
+   volume = 12,
+    pages = {381},
+      doi = {10.1175/1520-0426(1995)012<0381:MAOHPT>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="A. Iserles",
+title="A first course in the numerical analysis of differential equations",
+year=1996,
+edition="first",
+publisher="Cambridge University Press"}
+
+@book{Kundu_ea12bk,
+author="P. K. Kundu and I. M. Cohen and D. R. Dowling",
+title="Fluid Mechanics",
+year=2012,
+edition="Fifth",
+publisher="Academic Press"}
+
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} ==>>                Jones et al. (1990)
+ %   \citet*{key} ==>>               Jones, Baker, and Smith (1990)
+ %   \citep{key} ==>>                (Jones et al., 1990)
+ %   \citep*{key} ==>>               (Jones, Baker, and Smith, 1990)
+ %   \citep[chap. 2]{key} ==>>       (Jones et al., 1990, chap. 2)
+ %   \citep[e.g.][]{key} ==>>        (e.g. Jones et al., 1990)
+ %   \citep[e.g.][p. 32]{key} ==>>   (e.g. Jones et al., p. 32)
+ %   \citeauthor{key} ==>>           Jones et al.
+ %   \citeauthor*{key} ==>>          Jones, Baker, and Smith
+ %   \citeyear{key} ==>>             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 =
+    { ", " * write$ }
+    { output.state after.block =
+        { add.period$ write$
+          newline$
+          "</font>
<font color="blue">ewblock " write$
+        }
+        { output.state before.all =
+            'write$
+            { add.period$ " " * write$ }
+          if$
+        }
+      if$
+      mid.sentence 'output.state :=
+    }
+  if$
+  s
+}
+
+FUNCTION {output}
+{ duplicate$ empty$
+    'pop$
+    'output.nonnull
+  if$
+}
+
+FUNCTION {output.check}
+{ 't :=
+  duplicate$ empty$
+    { pop$ "empty " t * " in " * 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}
+{  " " * before.all 'output.state :=
+}
+
+FUNCTION {add.colon}
+{ duplicate$ empty$
+    'skip$
+    { ":" * 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$ "" }
+    'skip$
+  if$
+}
+
+FUNCTION {emphasize}
+{ duplicate$ empty$
+    { pop$ "" }
+    { "{\it " swap$ * "\/}" * }
+  if$
+}
+
+FUNCTION {bolden}
+{ duplicate$ empty$
+    { pop$ "" }
+    { "{\bf " swap$ * "}" * }
+  if$
+}
+
+FUNCTION {capitalize}
+{ "u" change.case$ "t" change.case$ }
+
+FUNCTION {space.word}
+{ " " swap$ * " " * }
+
+ % 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}
+{ "and"}
+
+FUNCTION {bbl.etal}
+{ "et~al." }
+
+FUNCTION {bbl.editors}
+{ "eds." }
+
+FUNCTION {bbl.editor}
+{ "ed." }
+
+FUNCTION {bbl.edby}
+{ "edited by" }
+
+FUNCTION {bbl.edition}
+{ "edition" }
+
+FUNCTION {bbl.volume}
+{ "volume" }
+
+FUNCTION {bbl.of}
+{ "of" }
+
+FUNCTION {bbl.number}
+{ "number" }
+
+FUNCTION {bbl.nr}
+{ "no." }
+
+FUNCTION {bbl.in}
+{ "in" }
+
+FUNCTION {bbl.pages}
+{ "pp." }
+
+FUNCTION {bbl.page}
+{ "p." }
+
+FUNCTION {bbl.chapter}
+{ "chapter" }
+
+FUNCTION {bbl.techrep}
+{ "Technical Report" }
+
+FUNCTION {bbl.mthesis}
+{ "Master's thesis" }
+
+FUNCTION {bbl.phdthesis}
+{ "Ph.D. thesis" }
+
+MACRO {jan} {"January"}
+
+MACRO {feb} {"February"}
+
+MACRO {mar} {"March"}
+
+MACRO {apr} {"April"}
+
+MACRO {may} {"May"}
+
+MACRO {jun} {"June"}
+
+MACRO {jul} {"July"}
+
+MACRO {aug} {"August"}
+
+MACRO {sep} {"September"}
+
+MACRO {oct} {"October"}
+
+MACRO {nov} {"November"}
+
+MACRO {dec} {"December"}
+
+
+ %-------------------------------------------------------------------
+ % Begin module:
+ % \ProvidesFile{physjour.mbs}[1999/02/24 2.0d (PWD)]
+MACRO {ar} {"Atmos. Res."}
+
+MACRO {aa}{"Astron. \& Astrophys."}
+MACRO {aasup}{"Astron. \& Astrophys. Suppl. Ser."}
+MACRO {aph} {"Acta Phys."}
+MACRO {advp} {"Adv. Phys."}
+MACRO {ajp} {"Amer. J. Phys."}
+MACRO {ajm} {"Amer. J. Math."}
+MACRO {amsci} {"Amer. Sci."}
+MACRO {anofd} {"Ann. Fluid Dyn."}
+MACRO {am} {"Ann. Math."}
+MACRO {ap} {"Ann. Phys. (NY)"}
+MACRO {adp} {"Ann. Phys. (Leipzig)"}
+MACRO {ao} {"Appl. Opt."}
+MACRO {apl} {"Appl. Phys. Lett."}
+MACRO {app} {"Astroparticle Phys."}
+MACRO {apj} {"Astrophys. J."}
+MACRO {apjsup} {"Astrophys. J. Suppl. Ser."}
+MACRO {baps} {"Bull. Amer. Phys. Soc."}
+MACRO {cmp} {"Comm. Math. Phys."}
+MACRO {cpam} {"Commun. Pure Appl. Math."}
+MACRO {cppcf} {"Comm. Plasma Phys. \& Controlled Fusion"}
+MACRO {cpc} {"Comp. Phys. Comm."}
+MACRO {cqg} {"Class. Quant. Grav."}
+MACRO {cra} {"C. R. Acad. Sci. A"}
+MACRO {fed} {"Fusion Eng. \& Design"}
+MACRO {ft} {"Fusion Tech."}
+MACRO {grg} {"Gen. Relativ. Gravit."}
+MACRO {ieeens} {"IEEE Trans. Nucl. Sci."}
+MACRO {ieeeps} {"IEEE Trans. Plasma Sci."}
+MACRO {ijimw} {"Interntl. J. Infrared \& Millimeter Waves"}
+MACRO {ip} {"Infrared Phys."}
+MACRO {irp} {"Infrared Phys."}
+MACRO {jap} {"J. Appl. Phys."}
+MACRO {jasa} {"J. Acoust. Soc. America"}
+MACRO {jcp} {"J. Comp. Phys."}
+MACRO {jetp} {"Sov. Phys.--JETP"}
+MACRO {jfe} {"J. Fusion Energy"}
+MACRO {jfm} {"J. Fluid Mech."}
+MACRO {jmp} {"J. Math. Phys."}
+MACRO {jne} {"J. Nucl. Energy"}
+MACRO {jnec} {"J. Nucl. Energy, C: Plasma Phys., Accelerators, Thermonucl. Res."}
+MACRO {jnm} {"J. Nucl. Mat."}
+MACRO {jpc} {"J. Phys. Chem."}
+MACRO {jpp} {"J. Plasma Phys."}
+MACRO {jpsj} {"J. Phys. Soc. Japan"}
+MACRO {jsi} {"J. Sci. Instrum."}
+MACRO {jvst} {"J. Vac. Sci. \& Tech."}
+MACRO {nat} {"Nature"}
+MACRO {nature} {"Nature"}
+MACRO {nedf} {"Nucl. Eng. \& Design/Fusion"}
+MACRO {nf} {"Nucl. Fusion"}
+MACRO {nim} {"Nucl. Inst. \& Meth."}
+MACRO {nimpr} {"Nucl. Inst. \& Meth. in Phys. Res."}
+MACRO {np} {"Nucl. Phys."}
+MACRO {npb} {"Nucl. Phys. B"}
+MACRO {nt/f} {"Nucl. Tech./Fusion"}
+MACRO {npbpc} {"Nucl. Phys. B (Proc. Suppl.)"}
+MACRO {inc} {"Nuovo Cimento"}
+MACRO {nc} {"Nuovo Cimento"}
+MACRO {pf} {"Phys. Fluids"}
+MACRO {pfa} {"Phys. Fluids A: Fluid Dyn."}
+MACRO {pfb} {"Phys. Fluids B: Plasma Phys."}
+MACRO {pl} {"Phys. Lett."}
+MACRO {pla} {"Phys. Lett. A"}
+MACRO {plb} {"Phys. Lett. B"}
+MACRO {prep} {"Phys. Rep."}
+MACRO {pnas} {"Proc. Nat. Acad. Sci. USA"}
+MACRO {pp} {"Phys. Plasmas"}
+MACRO {ppcf} {"Plasma Phys. \& Controlled Fusion"}
+MACRO {phitrsl} {"Philos. Trans. Roy. Soc. London"}
+MACRO {prl} {"Phys. Rev. Lett."}
+MACRO {pr} {"Phys. Rev."}
+MACRO {physrev} {"Phys. Rev."}
+MACRO {pra} {"Phys. Rev. A"}
+MACRO {prb} {"Phys. Rev. B"}
+MACRO {prc} {"Phys. Rev. C"}
+MACRO {prd} {"Phys. Rev. D"}
+MACRO {pre} {"Phys. Rev. E"}
+MACRO {ps} {"Phys. Scripta"}
+MACRO {procrsl} {"Proc. Roy. Soc. London"}
+MACRO {rmp} {"Rev. Mod. Phys."}
+MACRO {rsi} {"Rev. Sci. Inst."}
+MACRO {science} {"Science"}
+MACRO {sciam} {"Sci. Am."}
+MACRO {sam} {"Stud. Appl. Math."}
+MACRO {sjpp} {"Sov. J. Plasma Phys."}
+MACRO {spd} {"Sov. Phys.--Doklady"}
+MACRO {sptp} {"Sov. Phys.--Tech. Phys."}
+MACRO {spu} {"Sov. Phys.--Uspeki"}
+ % End module: physjour.mbs
+ %-------------------------------------------------------------------
+ % Begin module:
+ % \ProvidesFile{geojour.mbs}[1999/02/24 2.0e (PWD)]
+MACRO {aisr} {"Adv. Space Res."}
+MACRO {ag} {"Ann. Geophys."}
+MACRO {anigeo} {"Ann. Geofis."}
+MACRO {angl} {"Ann. Glaciol."}
+MACRO {andmet} {"Ann. d. Meteor."}
+MACRO {andgeo} {"Ann. d. Geophys."}
+MACRO {andphy} {"Ann. d. Phys."}
+MACRO {afmgb} {"Arch. Meteor. Geophys. Bioklimatol."}
+MACRO {atph} {"Atm\'osphera"}
+MACRO {aao} {"Atmos.-Ocean"}
+MACRO {ass}{"Astrophys. Space Sci."}
+MACRO {atenv} {"Atmos. Environ."}
+MACRO {aujag} {"Aust. J. Agric. Res."}
+MACRO {aumet} {"Aust. Meteor. Mag."}
+MACRO {blmet} {"Bound.-Layer Meteor."}
+MACRO {bams} {"Bull. Amer. Meteor. Soc."}
+MACRO {cch} {"Clim. Change"}
+MACRO {cdyn} {"Climate Dyn."}
+MACRO {cbul} {"Climatol. Bull."}
+MACRO {cap} {"Contrib. Atmos. Phys."}
+MACRO {dsr} {"Deep-Sea Res."}
+MACRO {dhz} {"Dtsch. Hydrogr. Z."}
+MACRO {dao} {"Dyn. Atmos. Oceans"}
+MACRO {eco} {"Ecology"}
+MACRO {empl}{"Earth, Moon and Planets"}
+MACRO {envres} {"Environ. Res."}
+MACRO {envst} {"Environ. Sci. Technol."}
+MACRO {ecms} {"Estuarine Coastal Mar. Sci."}
+MACRO {expa}{"Exper. Astron."}
+MACRO {geoint} {"Geofis. Int."}
+MACRO {geopub} {"Geofys. Publ."}
+MACRO {geogeo} {"Geol. Geofiz."}
+MACRO {gafd} {"Geophys. Astrophys. Fluid Dyn."}
+MACRO {gfd} {"Geophys. Fluid Dyn."}
+MACRO {geomag} {"Geophys. Mag."}
+MACRO {georl} {"Geophys. Res. Lett."}
+MACRO {grl} {"Geophys. Res. Lett."}
+MACRO {ga} {"Geophysica"}
+MACRO {gs} {"Geophysics"}
+MACRO {ieeetap} {"IEEE Trans. Antennas Propag."}
+MACRO {ijawp} {"Int. J. Air Water Pollut."}
+MACRO {ijc} {"Int. J. Climatol."}
+MACRO {ijrs} {"Int. J. Remote Sensing"}
+MACRO {jam} {"J. Appl. Meteor."}
+MACRO {jaot} {"J. Atmos. Ocean. Technol."}
+MACRO {jatp} {"J. Atmos. Terr. Phys."}
+MACRO {jce} {"J. Climate"}
+MACRO {jcam} {"J. Climate Appl. Meteor."}
+MACRO {jcm} {"J. Climate Meteor."}
+MACRO {jcy} {"J. Climatol."}
+MACRO {jgr} {"J. Geophys. Res."}
+MACRO {jga} {"J. Glaciol."}
+MACRO {jh} {"J. Hydrol."}
+MACRO {jmr} {"J. Mar. Res."}
+MACRO {jmrj} {"J. Meteor. Res. Japan"}
+MACRO {jm} {"J. Meteor."}
+MACRO {jpo} {"J. Phys. Oceanogr."}
+MACRO {jra} {"J. Rech. Atmos."}
+MACRO {jaes} {"J. Aeronaut. Sci."}
+MACRO {japca} {"J. Air Pollut. Control Assoc."}
+MACRO {jas} {"J. Atmos. Sci."}
+MACRO {jmts} {"J. Mar. Technol. Soc."}
+MACRO {jmsj} {"J. Meteor. Soc. Japan"}
+MACRO {josj} {"J. Oceanogr. Soc. Japan"}
+MACRO {jwm} {"J. Wea. Mod."}
+MACRO {lao} {"Limnol. Oceanogr."}
+MACRO {mwl} {"Mar. Wea. Log"}
+MACRO {mau} {"Mausam"}
+MACRO {meteor} {"``Meteor'' Forschungsergeb."}
+MACRO {map} {"Met. Atmos. Phys."}
+MACRO {metmag} {"Meteor. Mag."}
+MACRO {metmon} {"Meteor. Monogr."}
+MACRO {metrun} {"Meteor. Rundsch."}
+MACRO {metzeit} {"Meteor. Z."}
+MACRO {metgid} {"Meteor. Gidrol."}
+MACRO {mwr} {"Mon. Wea. Rev."}
+MACRO {nwd} {"Natl. Wea. Dig."}
+MACRO {nzjmfr} {"N. Z. J. Mar. Freshwater Res."}
+MACRO {npg} {"Nonlin. Proc. Geophys."}
+MACRO {om} {"Oceanogr. Meteor."}
+MACRO {ocac} {"Oceanol. Acta"}
+MACRO {oceanus} {"Oceanus"}
+MACRO {paleoc} {"Paleoceanography"}
+MACRO {pce} {"Physics and Chemistry of the Earth"}
+MACRO {pmg} {"Pap. Meteor. Geophys."}
+MACRO {ppom} {"Pap. Phys. Oceanogr. Meteor."}
+MACRO {physzeit} {"Phys. Z."}
+MACRO {pps} {"Planet. Space Sci."}
+MACRO {pss} {"Planet. Space Sci."}
+MACRO {pag} {"Pure Appl. Geophys."}
+MACRO {qjrms} {"Quart. J. Roy. Meteor. Soc."}
+MACRO {quatres} {"Quat. Res."}
+MACRO {rsci} {"Radio Sci."}
+MACRO {rse} {"Remote Sens. Environ."}
+MACRO {rgeo} {"Rev. Geophys."}
+MACRO {rgsp} {"Rev. Geophys. Space Phys."}
+MACRO {rdgeo} {"Rev. Geofis."}
+MACRO {revmeta} {"Rev. Meteor."}
+MACRO {sgp}{"Surveys in Geophys."}
+MACRO {sp} {"Solar Phys."}
+MACRO {ssr} {"Space Sci. Rev."}
+MACRO {tellus} {"Tellus"}
+MACRO {tac} {"Theor. Appl. Climatol."}
+MACRO {tagu} {"Trans. Am. Geophys. Union (EOS)"}
+MACRO {wrr} {"Water Resour. Res."}
+MACRO {weather} {"Weather"}
+MACRO {wafc} {"Wea. Forecasting"}
+MACRO {ww} {"Weatherwise"}
+MACRO {wmob} {"WMO Bull."}
+MACRO {zeitmet} {"Z. Meteor."}
+ % End module: geojour.mbs
+%% Copyright 1994-1999 Patrick W Daly
+
+MACRO {acmcs} {"ACM Comput. Surv."}
+
+MACRO {acta} {"Acta Inf."}
+
+MACRO {cacm} {"Commun. ACM"}
+
+MACRO {ibmjrd} {"IBM J. Res. Dev."}
+
+MACRO {ibmsj} {"IBM Syst.~J."}
+
+MACRO {ieeese} {"IEEE Trans. Softw. Eng."}
+
+MACRO {ieeetc} {"IEEE Trans. Comput."}
+
+MACRO {ieeetcad}
+ {"IEEE Trans. Comput.-Aided Design Integrated Circuits"}
+
+MACRO {ipl} {"Inf. Process. Lett."}
+
+MACRO {jacm} {"J.~ACM"}
+
+MACRO {jcss} {"J.~Comput. Syst. Sci."}
+
+MACRO {scp} {"Sci. Comput. Programming"}
+
+MACRO {sicomp} {"SIAM J. Comput."}
+
+MACRO {tocs} {"ACM Trans. Comput. Syst."}
+
+MACRO {tods} {"ACM Trans. Database Syst."}
+
+MACRO {tog} {"ACM Trans. Gr."}
+
+MACRO {toms} {"ACM Trans. Math. Softw."}
+
+MACRO {toois} {"ACM Trans. Office Inf. Syst."}
+
+MACRO {toplas} {"ACM Trans. Prog. Lang. Syst."}
+
+MACRO {tcs} {"Theoretical Comput. Sci."}
+
+FUNCTION {write.url}
+{ url empty$
+    { skip$ }
+    { "</font>
<font color="blue">ewline\urlprefix\url{" url * "}" * write$ newline$ }
+  if$
+}
+
+FUNCTION {format.doi}
+{ doi empty$
+    { "" }
+    { "doi:" doi * }
+  if$
+}
+
+INTEGERS { nameptr namesleft numnames }
+
+FUNCTION {format.names}
+{ 's :=
+  #1 'nameptr :=
+  s num.names$ 'numnames :=
+  numnames 'namesleft :=
+    { namesleft #0 > }
+    { nameptr #1 >
+        { s nameptr "{f.~}{vv~}{ll}{, jj}" format.name$  }
+        { s nameptr "{vv~}{ll}{, f.}{, jj}" format.name$  }
+      if$
+    't :=
+      nameptr #1 >
+        {
+          namesleft #1 >
+            { ", " * t * }
+            {
+              numnames #2 >
+                { "," * }
+                'skip$
+              if$
+              s nameptr "{ll}" format.name$ duplicate$ "others" =
+                { 't := }
+                { pop$ }
+              if$
+              t "others" =
+                {
+                  " " * 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 > }
+    { s nameptr
+      "{f.~}{vv~}{ll}{, jj}"
+      format.name$
+      't :=
+      nameptr #1 >
+        {
+          namesleft #1 >
+            { ", " * t * }
+            {
+              numnames #2 >
+                { "," * }
+                'skip$
+              if$
+              s nameptr "{ll}" format.name$ duplicate$ "others" =
+                { 't := }
+                { pop$ }
+              if$
+              t "others" =
+                {
+
+                  " " * 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 }
+    { "" }
+  if$
+}
+
+FUNCTION {format.authors}
+{ author empty$
+    { "" }
+    { author format.names }
+  if$
+}
+
+FUNCTION {format.editors}
+{ editor empty$
+    { "" }
+    { editor format.names
+      editor num.names$ #1 >
+        { ", " * bbl.editors * }
+        { ", " * bbl.editor * }
+      if$
+    }
+  if$
+}
+
+FUNCTION {format.in.editors}
+{ editor empty$
+    { "" }
+    { editor format.names.ed
+    }
+  if$
+}
+
+FUNCTION {format.book.pages}
+{ pages empty$
+    { "" }
+    { pages " " * bbl.pages * }
+  if$
+}
+
+FUNCTION {format.note}
+{
+ note empty$
+    { "" }
+    { note #1 #1 substring$
+      duplicate$ "{" =
+        'skip$
+        { output.state mid.sentence =
+          { "l" }
+          { "u" }
+        if$
+        change.case$
+        }
+      if$
+      note #2 global.max$ substring$ *
+    }
+  if$
+}
+
+FUNCTION {format.title}
+{ title empty$
+    { "" }
+    { title "t" change.case$
+    }
+  if$
+}
+
+FUNCTION {format.full.names}
+{'s :=
+  #1 'nameptr :=
+  s num.names$ 'numnames :=
+  numnames 'namesleft :=
+    { namesleft #0 > }
+    { s nameptr
+      "{vv~}{ll}" format.name$
+      't :=
+      nameptr #1 >
+        {
+          namesleft #1 >
+            { ", " * t * }
+            {
+              numnames #2 >
+                { "," * }
+                'skip$
+              if$
+              s nameptr "{ll}" format.name$ duplicate$ "others" =
+                { 't := }
+                { pop$ }
+              if$
+              t "others" =
+                {
+                  " " * 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$ "book" =
+  type$ "inbook" =
+  or
+    'author.editor.key.full
+    { type$ "proceedings" =
+        'editor.key.full
+        'author.key.full
+      if$
+    }
+  if$
+}
+
+FUNCTION {output.bibitem}
+{ newline$
+  "\bibitem[{" write$
+  label write$
+  ")" make.full.names duplicate$ short.list =
+     { pop$ }
+     { * }
+   if$
+  "}]{" * write$
+  cite$ write$
+  "}" write$
+  newline$
+  ""
+  before.all 'output.state :=
+}
+
+FUNCTION {n.dashify}
+{
+  't :=
+  ""
+    { t empty$ not }
+    { t #1 #1 substring$ "-" =
+        { t #1 #2 substring$ "--" = not
+            { "--" *
+              t #2 global.max$ substring$ 't :=
+            }
+            {   { t #1 #1 substring$ "-" = }
+                { "-" *
+                  t #2 global.max$ substring$ 't :=
+                }
+              while$
+            }
+          if$
+        }
+        { t #1 #1 substring$ *
+          t #2 global.max$ substring$ 't :=
+        }
+      if$
+    }
+  while$
+}
+
+FUNCTION {word.in}
+{ "" }
+
+FUNCTION {format.date}
+{ year duplicate$ empty$
+    { "empty year in " cite$ * "; set to ????" * warning$
+       pop$ "????" }
+    'skip$
+  if$
+  extra.label *
+}
+
+FUNCTION {format.btitle}
+{ title emphasize
+}
+
+FUNCTION {tie.or.space.connect}
+{ duplicate$ text.length$ #3 <
+    { "~" }
+    { " " }
+  if$
+  swap$ * *
+}
+
+FUNCTION {either.or.check}
+{ empty$
+    'pop$
+    { "can't use both " swap$ * " fields in " * cite$ * warning$ }
+  if$
+}
+
+FUNCTION {format.bvolume}
+{ volume empty$
+    { "" }
+    { bbl.volume volume tie.or.space.connect
+      series empty$
+        'skip$
+        { bbl.of space.word * series emphasize * }
+      if$
+      "volume and number" 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$
+            { "there's a number but no series in " cite$ * warning$ }
+            { bbl.in space.word * series * }
+          if$
+        }
+      if$
+    }
+    { "" }
+  if$
+}
+
+
+FUNCTION {format.edition}
+{ edition empty$
+    { "" }
+    { output.state mid.sentence =
+        { edition "l" change.case$ " " * bbl.edition * }
+        { edition "t" change.case$ " " * bbl.edition * }
+      if$
+    }
+  if$
+}
+
+INTEGERS { multiresult }
+
+FUNCTION {multi.page.check}
+{ 't :=
+  #0 'multiresult :=
+    { multiresult not
+      t empty$ not
+      and
+    }
+    { t #1 #1 substring$
+      duplicate$ "-" =
+      swap$ duplicate$ "," =
+      swap$ "+" =
+      or or
+        { #1 'multiresult := }
+        { t #2 global.max$ substring$ 't := }
+      if$
+    }
+  while$
+  multiresult
+}
+
+FUNCTION {format.pages}
+{ pages empty$
+    { "" }
+    { pages multi.page.check
+        { pages n.dashify }
+        { pages }
+      if$
+    }
+  if$
+}
+
+FUNCTION {format.journal.pages}
+{ pages empty$
+    'skip$
+    { duplicate$ empty$
+        { pop$ format.pages }
+        {
+          ", " *
+          pages n.dashify *
+        }
+      if$
+    }
+  if$
+}
+
+FUNCTION {format.vol.num.pages}
+{ volume field.or.null
+  bolden
+}
+
+FUNCTION {format.chapter.pages}
+{ chapter empty$
+    { "" }
+    { type empty$
+        { bbl.chapter }
+        { type "l" change.case$ }
+      if$
+      chapter tie.or.space.connect
+    }
+  if$
+}
+
+FUNCTION {format.in.ed.booktitle}
+{ booktitle empty$
+    { "" }
+    { editor empty$
+        { word.in booktitle emphasize * }
+        { word.in booktitle emphasize *
+          ", " *
+          format.in.editors *
+          ", " *
+          editor num.names$ #1 >
+            { bbl.editors }
+            { bbl.editor }
+          if$
+          *
+        }
+      if$
+    }
+  if$
+}
+
+FUNCTION {format.thesis.type}
+{ type empty$
+    'skip$
+    { pop$
+      type "t" change.case$
+    }
+  if$
+}
+
+FUNCTION {format.tr.number}
+{ type empty$
+    { bbl.techrep }
+    'type
+  if$
+  number empty$
+    { "t" change.case$ }
+    { number tie.or.space.connect }
+  if$
+}
+
+FUNCTION {format.article.crossref}
+{
+  word.in
+  " \cite{" * crossref * "}" *
+}
+
+FUNCTION {format.book.crossref}
+{ volume empty$
+    { "empty volume in " cite$ * "'s crossref of " * crossref * warning$
+      word.in
+    }
+    { bbl.volume capitalize
+      volume tie.or.space.connect
+      bbl.of space.word *
+    }
+  if$
+  " \cite{" * crossref * "}" *
+}
+
+FUNCTION {format.incoll.inproc.crossref}
+{
+  word.in
+  " \cite{" * crossref * "}" *
+}
+
+FUNCTION {format.org.or.pub}
+{ 't :=
+  ""
+  address empty$ t empty$ and
+    'skip$
+    {
+      t empty$
+        { address empty$
+          'skip$
+          { address * }
+          if$
+        }
+        { t *
+          address empty$
+            'skip$
+            { ", " * address * }
+          if$
+        }
+      if$
+    }
+  if$
+}
+
+FUNCTION {format.publisher.address}
+{ publisher empty$
+    { "empty publisher in " cite$ * warning$
+      ""
+    }
+    { publisher }
+  if$
+  format.org.or.pub
+}
+
+FUNCTION {format.organization.address}
+{ organization empty$
+    { "" }
+    { organization }
+  if$
+  format.org.or.pub
+}
+
+STRINGS {oldname}
+
+FUNCTION {name.or.dash}
+{ 's :=
+   oldname empty$
+     { s 'oldname := s }
+     { s oldname =
+         { "---" add.blank }
+         { s 'oldname := s }
+       if$
+     }
+   if$
+}
+
+FUNCTION {article}
+{ output.bibitem
+  format.authors "author" output.check
+  author format.key output
+  name.or.dash
+  format.date "year" output.check
+  add.colon
+  date.block
+  format.title "title" output.check
+  new.sentence
+  crossref missing$
+    { journal
+      emphasize
+      "journal" 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 "author and editor" output.check
+      editor format.key output
+      name.or.dash
+    }
+    { format.authors output.nonnull
+      name.or.dash
+      crossref missing$
+        { "author and editor" editor either.or.check }
+        'skip$
+      if$
+    }
+  if$
+  format.date "year" output.check
+  add.colon
+  date.block
+  format.btitle "title" 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 "year" output.check
+  add.colon
+  date.block
+  format.title "title" 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 "author and editor" output.check
+      editor format.key output
+      name.or.dash
+    }
+    { format.authors output.nonnull
+      name.or.dash
+      crossref missing$
+        { "author and editor" editor either.or.check }
+        'skip$
+      if$
+    }
+  if$
+  format.date "year" output.check
+  add.colon
+  date.block
+  format.btitle "title" output.check
+  crossref missing$
+    {
+      format.publisher.address output
+      format.bvolume output
+      format.chapter.pages "chapter and pages" output.check
+  new.sentence
+      format.number.series output
+    }
+    {
+      format.chapter.pages "chapter and pages" output.check
+  new.sentence
+      format.book.crossref output.nonnull
+    }
+  if$
+  format.edition output
+  format.pages "pages" output.check
+  format.note output
+  fin.entry
+  write.url
+}
+
+FUNCTION {incollection}
+{ output.bibitem
+  format.authors "author" output.check
+  author format.key output
+  name.or.dash
+  format.date "year" output.check
+  add.colon
+  date.block
+  format.title "title" output.check
+  new.sentence
+  crossref missing$
+    { format.in.ed.booktitle "booktitle" 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 "pages" output.check
+  format.note output
+  fin.entry
+  write.url
+}
+
+FUNCTION {inproceedings}
+{ output.bibitem
+  format.authors "author" output.check
+  author format.key output
+  name.or.dash
+  format.date "year" output.check
+  add.colon
+  date.block
+  format.title "title" output.check
+  new.sentence
+  crossref missing$
+    { format.in.ed.booktitle "booktitle" 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 "year" output.check
+  add.colon
+  date.block
+  format.btitle "title" output.check
+  new.sentence
+  organization output
+  address output
+  format.edition output
+  format.note output
+  fin.entry
+  write.url
+}
+
+FUNCTION {mastersthesis}
+{ output.bibitem
+  format.authors "author" output.check
+  author format.key output
+  name.or.dash
+  format.date "year" output.check
+  add.colon
+  date.block
+  format.btitle "title" output.check
+  new.sentence
+  bbl.mthesis format.thesis.type output.nonnull
+  school "school" 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 "year" 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 "author" output.check
+  author format.key output
+  name.or.dash
+  format.date "year" output.check
+  add.colon
+  date.block
+  format.btitle "title" output.check
+  new.sentence
+  bbl.phdthesis format.thesis.type output.nonnull
+  school "school" 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 "year" output.check
+  add.colon
+  date.block
+  format.btitle "title" 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 "author" output.check
+  author format.key output
+  name.or.dash
+  format.date "year" output.check
+  add.colon
+  date.block
+  format.title "title" output.check
+  new.sentence
+  format.tr.number output.nonnull
+  institution "institution" output.check
+  address output
+  format.note output
+  fin.entry
+  write.url
+}
+
+FUNCTION {unpublished}
+{ output.bibitem
+  format.authors "author" output.check
+  author format.key output
+  name.or.dash
+  format.date "year" output.check
+  add.colon
+  date.block
+  format.title "title" output.check
+  format.note "note" output.check
+  fin.entry
+  write.url
+}
+
+FUNCTION {default.type} { misc }
+
+READ
+
+FUNCTION {sortify}
+{ purify$
+  "l" 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 "{vv~}{ll}" format.name$
+  s num.names$ duplicate$
+  #2 >
+    { pop$
+      " " * bbl.etal *
+    }
+    { #2 <
+        'skip$
+        { s #2 "{ff }{vv }{ll}{ jj}" format.name$ "others" =
+            {
+              " " * bbl.etal *
+            }
+            { bbl.and space.word * s #2 "{vv~}{ll}" 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$ "book" =
+  type$ "inbook" =
+  or
+    'author.editor.key.label
+    { type$ "proceedings" =
+        'editor.key.label
+        'author.key.label
+      if$
+    }
+  if$
+  'short.list :=
+}
+
+FUNCTION {calc.label}
+{ calc.short.authors
+  short.list
+  "("
+  *
+  year duplicate$ empty$
+     { pop$ "????" }
+     'skip$
+  if$
+  *
+  'label :=
+}
+
+FUNCTION {sort.format.names}
+{ 's :=
+  #1 'nameptr :=
+  ""
+  s num.names$ 'numnames :=
+  numnames 'namesleft :=
+    { namesleft #0 > }
+    { s nameptr
+      "{vv{ } }{ll{ }}{  f{ }}{  jj{ }}"
+      format.name$ 't :=
+      nameptr #1 >
+        {
+          "   "  *
+          namesleft #1 = t "others" = and
+            { "zzzzz" * }
+            { t sortify * }
+          if$
+        }
+        { t sortify * }
+      if$
+      nameptr #1 + 'nameptr :=
+      namesleft #1 - 'namesleft :=
+    }
+  while$
+}
+
+FUNCTION {sort.format.title}
+{ 't :=
+  "A " #2
+    "An " #3
+      "The " #4 t chop.word
+    chop.word
+  chop.word
+  sortify
+  #1 global.max$ substring$
+}
+
+FUNCTION {author.sort}
+{ author empty$
+    { key empty$
+        { "to sort, need author or key in " cite$ * warning$
+          ""
+        }
+        { key sortify }
+      if$
+    }
+    { author sort.format.names }
+  if$
+}
+
+FUNCTION {author.editor.sort}
+{ author empty$
+    { editor empty$
+        { key empty$
+            { "to sort, need author, editor, or key in " cite$ * warning$
+              ""
+            }
+            { key sortify }
+          if$
+        }
+        { editor sort.format.names }
+      if$
+    }
+    { author sort.format.names }
+  if$
+}
+
+FUNCTION {editor.sort}
+{ editor empty$
+    { key empty$
+        { "to sort, need editor or key in " cite$ * warning$
+          ""
+        }
+        { key sortify }
+      if$
+    }
+    { editor sort.format.names }
+  if$
+}
+
+FUNCTION {presort}
+{ calc.label
+  label sortify
+  "    "
+  *
+  type$ "book" =
+  type$ "inbook" =
+  or
+    'author.editor.sort
+    { type$ "proceedings" =
+        'editor.sort
+        'author.sort
+      if$
+    }
+  if$
+  #1 entry.max$ substring$
+  'sort.label :=
+  sort.label
+  *
+  "    "
+  *
+  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 :=
+  "" '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 :=
+    }
+    { "a" chr.to.int$ 'last.extra.num :=
+      "" 'extra.label :=
+      label 'last.label :=
+    }
+  if$
+  number.label #1 + 'number.label :=
+}
+
+FUNCTION {reverse.pass}
+{ next.extra "b" =
+    { "a" 'extra.label := }
+    'skip$
+  if$
+  extra.label 'next.extra :=
+  extra.label
+  duplicate$ empty$
+    'skip$
+    { "{</font>
<font color="blue">atexlab{" swap$ * "}}" * }
+  if$
+  'extra.label :=
+  label extra.label * 'label :=
+}
+
+EXECUTE {initialize.extra.label.stuff}
+
+ITERATE {forward.pass}
+
+REVERSE {reverse.pass}
+
+FUNCTION {bib.sort.order}
+{ sort.label
+  "    "
+  *
+  year field.or.null sortify
+  *
+  "    "
+  *
+  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$
+  "\begin{thebibliography}{" number.label int.to.str$ * "}" *
+  write$ newline$
+  "\expandafter\ifx\csname natexlab\endcsname\relax\def</font>
<font color="gray">atexlab#1{#1}\fi"
+  write$ newline$
+  "\expandafter\ifx\csname url\endcsname\relax"
+  write$ newline$
+  "  \def\url#1{{\tt #1}}\fi"
+  write$ newline$
+  "\expandafter\ifx\csname urlprefix\endcsname\relax\def\urlprefix{URL }\fi"
+  write$ newline$
+  "\expandafter\ifx\csname doiprefix\endcsname\relax\def\doiprefix{doi:}\fi"
+  write$ newline$
+}
+
+EXECUTE {begin.bib}
+
+EXECUTE {init.state.consts}
+
+ITERATE {call.type$}
+
+FUNCTION {end.bib}
+{ newline$
+  "\end{thebibliography}" 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 = "{Numerical representation of geostrophic modes on arbitrarily structured C-grids}",
+  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 = "{A unified approach to energy conservation and potential vorticity dynamics for arbitrarily-structured C-grids}",
+  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 = "{A multiresolution method for climate system modeling: application of spherical centroidal Voronoi tessellations}",
+  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 = "{A Potential Enstrophy and Energy Conserving Numerical Scheme for Solution of the Shallow-Water Equations on a Geodesic Grid}",
+  journal = {Monthly Weather Review},
+     year = 2002,
+   volume = 130,
+    pages = {1397-+},
+      doi = {10.1175/1520-0493(2002)130<1397:APEAEC>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 = "{An Upwind-Biased Conservative Advection Scheme for Spherical Hexagonal Pentagonal Grids}",
+  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>