<p><b>mpetersen@lanl.gov</b> 2013-04-03 16:13:01 -0600 (Wed, 03 Apr 2013)</p><p>user's guide: wrote Foreword<br>
</p><hr noshade><pre><font color="gray">Modified: trunk/documents/users_guide/ocean/foreword.tex
===================================================================
--- trunk/documents/users_guide/ocean/foreword.tex 2013-04-03 20:47:30 UTC (rev 2722)
+++ trunk/documents/users_guide/ocean/foreword.tex 2013-04-03 22:13:01 UTC (rev 2723)
@@ -1,13 +1,29 @@
\chapter*{Foreword}
\label{chap:foreword}
-{\color{red}TBA: write foreword}
+The Model for Prediction Across Scales-Ocean (MPAS-Ocean) is an unstructured-mesh ocean model capable of using enhanced horizontal resolution in selected regions of the ocean domain. This allows researchers to perform high-resolution regional simulations at a lower computational cost, while providing realistic currents and water-mass properties from the low-resolution regions. Model domains may be spherical with bottom topography to simulate the earth's oceans, or on Cartesian domains for idealized experiments. The global meshes, created using Spherical Centroidal Voronoi Tesselations \citep{Ringler_ea08od,Ringler_ea11mwr} consist of gridcells that vary smoothly from low to high resolution regions. Numerical algorithms specifically designed for these grids guarantee that mass, tracers, potential vorticity (in isopycnal mode) and energy are conserved \citep{Thurburn_ea09jcp,Ringler_ea10jcp}. MPAS-Ocean high-resolution and variable-resolution global simulations, as well as
descriptions of mesh generation, model capabilities, and algorithms, are presented in \citet{Ringler_ea13om}.
-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
+MPAS-Ocean is one component within the MPAS framework of climate models that is developed in cooperation between Los Alamos National Laboratory (LANL) and the National Center for Atmospheric Research (NCAR). Functionality that is required by all cores, such as i/o, time management, block decomposition, etc, is developed collaboratively, and this code is shared across cores within the same repository. Each core then solves its own differential equations and physical parameterizations within this framework. This user's guide reflects the spirit of this collaborative process, where Part I, ``The MPAS Framework'', applies to all cores, and the remaining parts apply to MPAS-Ocean.
+Here we would normally describe the new features of this version. For the initial release, we will simply review the major features of MPAS-Ocean. We employ a finite-volume discretization of the Boussinesq equations using a C-grid staggering in the horizontal.
+The vertical coordinate is Arbitrary Lagrangian-Eulerian (ALE), with a choice of z-level, z-star, and idealized isopycnal. The time-stepping method may be split-explicit or fourth-order Runge-Kutta. Many choices are available for advection and turbulence closures. Our current high-resolution global simulations use a quasi 3$^{rd}$-order monotone advection scheme for tracers \citep{Skamarock:2011tc} and the Leith, enstrophy-cascade turbulence closure \citep{Leith:1996wu}.
+A history of past releases is as follows:
+
+\begin{tabular}{lll}
+\hline\hline version & date & description \\
+\hline
+1.0.0 & June 3, 2013 & Initial public release \\
+\hline
+\end{tabular}
+
+Information about MPAS-Ocean, including the most recent code, user's guide, and test cases, may be found at \href{http://mpas.sourceforge.net}{http://mpas.sourceforge.net}. This user's guide refers to version \version, with corresponding downloads at \href{http://mpas.sourceforge.net/ocean/release_\version/release_\version.html}{the website for version \version}.
+
+
+</font>
<font color="gray">oindent
+{\bf Contributors to this guide:}\\
+Doug Jacobsen, Mark Petersen, Todd Ringler\\
+{\bf Additional contributors to MPAS Framework sections:}\\
+Michael Duda
+
+
+
Modified: trunk/documents/users_guide/ocean/mpas_ocean.bib
===================================================================
--- trunk/documents/users_guide/ocean/mpas_ocean.bib 2013-04-03 20:47:30 UTC (rev 2722)
+++ trunk/documents/users_guide/ocean/mpas_ocean.bib 2013-04-03 22:13:01 UTC (rev 2723)
@@ -15,7 +15,6 @@
%%%%%%%% grid and numerics %%%%%%%%%
-
@unpublished{Ringler06unpub,
author = {{Ringler}, T.~D.},
title = "{Conservation of energy in viscous systems}",
@@ -24,26 +23,20 @@
month = "June"
}
-@article{Thuburn:2009tb,
-author = {Thuburn, J and Ringler, TD and Skamarock, WC and Klemp, JB},
-title = {{Numerical representation of geostrophic modes on arbitrarily structured C-grids}},
-journal = {Journal of Computational Physics},
-year = {2009},
-volume = {228},
-number = {22},
-pages = {8321--8335}
+@ARTICLE{Ringler_ea11mwr,
+ author = {{Ringler}, T.~D. and {Jacobsen}, D. and {Gunzburger}, M. and
+ {Ju}, L. and {Duda}, M. and {Skamarock}, W.},
+ title = "{Exploring a Multiresolution Modeling Approach within the Shallow-Water Equations}",
+ journal = {Monthly Weather Review},
+ year = 2011,
+ month = nov,
+ volume = 139,
+ pages = {3348-3368},
+ doi = {10.1175/MWR-D-10-05049.1},
+ adsurl = {http://adsabs.harvard.edu/abs/2011MWRv..139.3348R},
+ adsnote = {Provided by the SAO/NASA Astrophysics Data System}
}
-@article{Ringler:2010ta,
-author = {Ringler, TD and Thuburn, J and Klemp, JB and Skamarock, WC},
-title = {{A unified approach to energy conservation and potential vorticity dynamics for arbitrarily-structured C-grids}},
-journal = {Journal of Computational Physics},
-year = {2010},
-volume = {229},
-number = {9},
-pages = {3065--3090}
-}
-
%%%%%%%% test domains %%%%%%%%%
@ARTICLE{Ilicak_ea12om,
</font>
</pre>