<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>