Index: NEMO/branches/2019/fix_vvl_ticket1791/doc/latex/NEMO/main/NEMO_coding_conv.tex
===================================================================
--- NEMO/branches/2019/fix_vvl_ticket1791/doc/latex/NEMO/main/NEMO_coding_conv.tex	(revision 10999)
+++ 	(revision )
@@ -1,807 +1,0 @@
-\documentclass{article}
-
-\usepackage{fancyhdr}
-\usepackage{times}
-\usepackage{graphicx}
-\usepackage{hyperref}
-\usepackage{minted}
-%\usepackage[normalem]{ulem}   % striketrough style with \sout{...}
-
-\hypersetup{pdftitle={NEMO coding conventions}, pdfauthor={NEMO System Team}, colorlinks}
-\setminted{style=emacs, breaklines, frame=leftline}
-\newmintinline[forcode]{fortran}{fontsize=auto, frame=lines}   % \forcode{...}
-\newminted[forlines]{fortran}{}                                % \begin{forlines}
-
-\pagestyle{empty}
-\setlength{\leftmargin}{1 cm}
-\setlength{\rightmargin}{1 cm}
-\setlength{\oddsidemargin}{0 cm}
-\setlength{\evensidemargin}{0 cm}
-\setlength{\topmargin}{-1cm}
-\setlength{\textwidth}{16 cm}
-\setlength{\textheight}{25cm}
-\pagestyle{fancy}
-
-\title{
-  \includegraphics[width=0.3\textwidth]{../../../figures/NEMO_grey} \\
-  \vspace{1.0cm} \rule{345pt}{1.5pt} \\
-  \vspace{0.45cm} {\Huge NEMO coding conventions} \rule{345pt}{1.5pt} \\
-}
-%\title{NEMO coding conventions}
-\author{\Large NEMO System Team
-  \thanks{
-    To be completed
-  }
-}
-\date{version X.X -- month year}
-
-\begin{document}
-
-\maketitle
-
-\newpage
-
-\tableofcontents
-
-\newpage
-
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\section{Introduction}
-
-This document describes conventions\index{conventions} used in NEMO coding and suggested for its development.
-The objectives are to offer a guide to all readers of the NEMO code, and to facilitate the work of
-all the developers, including the validation of their developments, and
-eventually the implementation of these developments within the NEMO platform.
-
-A first approach of these rules can be found in the code in \path{./src/OCE/module_example} where
-all the basics coding conventions are illustrated.
-More details can be found below.
-
-This work is based on the coding conventions in use for the Community Climate System Model
-\footnote {\href{http://www.cesm.ucar.edu/working_groups/Software/dev_guide/dev_guide/node7.html}{UCAR conventions}}, 
-the previous version of this document (``FORTRAN coding standard in the OPA System'') and
-the expertise of the NEMO System Team.
-After a general overview below, this document will describe:
-
-\begin{itemize}
-\item
-  The style rules, $i.e.$ the syntax, appearance and naming conventions chosen to improve readability of the code;
-\item
-  The content rules, $i.e.$ the conventions to improve the reliability of the different parts of the code;
-\item
-  The package rules to go a step further by improving the reliability of the whole and
-  interfaces between routines and modules.
-\end{itemize}
-
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\section{Overview and general conventions}
-
-NEMO has 3 major components: ocean dynamics (\path{./src/OCE}), sea-ice (\path{./src/ICE}) and
-marine biogeochemistry (\path{./src/MBG}).
-%, linear-tangent and adjoint of the dynamics ($TAM$) each of them corresponding to a directory.
-In each directory, one will find some FORTRAN files and/or subdirectories, one per functionality of the code:
-\path{./src/OCE/BDY} (boundaries), \path{./src/OCE/DIA} (diagnostics), \path{./src/OCE/DOM} (domain),
-\path{./src/OCE/DYN} (dynamics), \path{./src/OCE/LDF} (lateral diffusion), etc... \\
-All name are chosen to be as self-explanatory as possible, in English, all prefixes are 3 digits. \\
-English is used for all variables names, comments, and documentation. \\
-Physical units are MKS. The only exception to this is the temperature, which is expressed in degrees Celsius,
-except in bulk formulae and part of SI$^3$ sea-ice model where it is in Kelvin.
-See \path{.src/OCE/DOM/phycst.F90} files for conversions.
-
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\section{Architecture}
-
-Within each directory, organisation of files is driven by orthogonality\index{orthogonality},
-$i.e.$ one functionality of the code is intended to be in one and only one directory, and
-one module and all its related routines are in one file.
-The functional modules\index{module} are:
-
-\begin{itemize}
-\item \path{SBC}             surface module
-\item \path{IOM}             management of the I/O
-\item \path{NST}             interface to AGRIF (nesting model) for dynamics and biogeochemistry
-\item \path{OBC}, \path{BDY} management of structured and unstructured open boundaries 
-\item \path{C1D}             1D (vertical) configuration for dynamics, sea-ice and biogeochemistry
-\item \path{OFF}             off-line module: passive tracer or biogeochemistry alone
-\item \path{...}
-\end{itemize}
-
-For example, the file \textit{domain.F90} contains the module \texttt{domain} and all the subroutines related to
-this module (\texttt{dom\_init, dom\_nam, dom\_ctl}).
-
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\section{Style rules}
-
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\subsection{Argument list format}
-
-Routine argument lists will contain a maximum 5 variables\index{variable} per line,
-whilst continuation lines can be used.
-This applies both to the calling routine and the dummy argument list in the routine being called.
-The purpose is to simplify matching up the arguments between caller and callee.
-
-\begin{forlines}
-SUBROUTINE tra_adv_eiv( kt, pun, pvn, pwn )
-
-      CALL tra_adv_eiv( kt, zun, zvn, zwn )
-\end{forlines}
-
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\subsection{Array syntax}
-
-Except for long loops (see below), array notation should be used if possible.
-To improve readability the array shape must be shown in brackets, $e.g.$:
-
-\begin{forlines}
-onedarraya(:)   = onedarrayb(:) + onedarrayc(:)
-twodarray (:,:) = scalar * anothertwodarray(:,:)
-\end{forlines}
-
-When accessing sections of arrays, for example in finite difference equations,
-do so by using the triplet notation on the full array, $e.g.$:
-
-\begin{forlines}
-twodarray(:,2:len2) =   scalar                      &
-   &                  * ( twodarray2(:,1:len2-1 )   &
-   &                  -   twodarray2(:,2:len2 ) )
-\end{forlines}
-
-For long, complicated loops, explicitly indexed loops should be preferred.
-In general when using this syntax, the order of the loops indices should reflect the following scheme
-(for best usage of data locality):
-
-\begin{forlines}
-DO jk = 1, jpk
-   DO jj = 1, jpj
-      DO ji = 1, jpi
-         threedarray(ji,jj,jk) = ...
-      END DO
-   END DO
-END DO
-\end{forlines}
-
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\subsection{Case}
-
-All FORTRAN keywords are in capital: \forcode{DIMENSION}, \forcode{WRITE}, \forcode{DO}, \forcode{END DO},
-\forcode{NAMELIST}, ... All other parts of the NEMO code will be written in lower case.
-
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\subsection{Comments}
-
-Comments in the code are useful when reading the code and changing or developing it. \\
-The full documentation and detailed explanations are to be added in the reference manual
-(TeX files, aside from the code itself). \\
-In the code, the comments should explain variable content and describe each computational step. \\
-Comments in the header start with ``!!''.
-For more details on the content of the headers, see Content rules/Headers in this document. \\
-Comments in the code start with ``!''. \\
-All comments are indented (3, 6, or 9 blank spaces). \\
-Short comments may be included on the same line as executable code, and an additional line can be used with
-proper alignment.
-For example:
-
-\begin{forlines}
-zx = zx *zzy   ! Describe what is going on and if it is
-!              ! too long use another ! for proper
-!              ! alignment with automatic indentation
-\end{forlines}
-
-More in-depth comments should be written in the form:
-
-\begin{forlines}
-   !  Check of some namelist values
-\end{forlines}
-
-or
-
-\begin{forlines}
-!
-!     !<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<
-!     !  Bottom boundary condition on tke
-!     !<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<
-!
-\end{forlines}
-
-Key features of this style are
-
-\begin{enumerate}
-\item it starts with a "!" in the column required for proper indentation,
-\item the text is offset above and below by a blank line or a content line built for underlying.
-\end{enumerate}
-
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\subsection{Continuation lines}
-
-Continuation lines can be used with precise alignment for readability. For example:
-
-\begin{forlines}
-avmu(ji,jj,jk) =   avmu(ji,jj,jk) * ( un(ji,jj,jk-1) - un(ji,jj,jk) )   &
-   &                              * ( ub(ji,jj,jk-1) - ub(ji,jj,jk) )   &
-   &             / (   fse3uw_n(ji,jj,jk)                               &
-   &                 * fse3uw_b(ji,jj,jk) )
-\end{forlines}
-
-Code lines, which are continuation lines of assignment statements, must begin to the right of the column of
-the assignment operator.
-Due to the possibility of automatic indentation in some editor (emacs for example),
-use a ``\&'' as first character of the continuing lines to maintain the alignment.
-
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\subsection{Declaration of arguments and local variables}
-
-In a routine, input arguments and local variables are declared 1 per line,
-with a comment field on the same line as the declaration.
-Multiple comment lines describing a single variable are acceptable if needed.
-For example:
-
-\begin{forlines}
-INTEGER             ::   kstp   ! ocean time-step index
-\end{forlines}
-
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\subsection{F90 Standard}
-
-NEMO software adheres to the FORTRAN 95 language standard and does not rely on any specific language or
-vendor extensions.
-
-
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\subsection{Free-Form Source}
-
-Free-form source will be used.
-The F90/95 standard allows lines of up to 132 characters, but a self-imposed limit of 80 should enhance readability,
-or print source files with two columns per page.
-Multi-line comments that extend to column 100 are unacceptable.
-
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\subsection{Indentation}
-
-Code as well as comment lines within loops, if-blocks, continuation lines, \forcode{MODULE} or
-\forcode{SUBROUTINE} statements will be indented 3 characters for readability
-(except for \forcode{CONTAINS} that remains at first column).
-
-\begin{forlines}
-MODULE mod1
-   REAL(wp) xx
-CONTAINS
-   SUBROUTINE sub76( px, py, pz, pw, pa,   &
-      &              pb, pc, pd, pe          )
-      <instruction>
-   END SUBROUTINE sub76
-END MODULE mod1
-\end{forlines}
-
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\subsection{Loops}
-
-Loops, if explicit, should be structured with the do-end do construct as opposed to numbered loops.
-Nevertheless non-numeric labels can be used for a big iterative loop of a recursive algorithm.
-In the case of a long loop, a self-descriptive label can be used ($i.e.$ not just a number).
-
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\subsection{Naming Conventions: files}
-
-A file containing a module will have the same name as the module it contains
-(because dependency rules used by "make" programs are based on file names).
-\footnote{
-  For example, if routine A "\forcode{USE}"s module B, then "make" must be told of the dependency relation which
-  requires B to be compiled before A.
-  If one can assume that module B resides in file B.o,
-  building a tool to generate this dependency rule ($e.g.$ A.o: B.o) is quite simple.
-  Put another way, it is difficult (to say nothing of CPU-intensive) to search an entire source tree to
-  find the file in which module B resides for each routine or module which "\forcode{USE}"s B.
-}
-
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\subsection{Naming Conventions: modules}
-
-Use a meaningful English name and the ``3 letters'' naming convention:
-first 3 letters for the code section, and last 3 to describe the module.
-For example, zdftke, where ``zdf'' stands for vertical diffusion, and ``tke'' for turbulent kinetic energy. \\
-Note that by implication multiple modules are not allowed in a single file.
-The use of common blocks is deprecated in Fortran 90 and their use in NEMO is strongly discouraged.
-Modules are a better way to declare static data.
-Among the advantages of modules is the ability to freely mix data of various types, and
-to limit access to contained variables through the use of the \forcode{ONLY} and \forcode{PRIVATE} attributes.
-
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\subsection{Naming Conventions: variables}
-
-All variable should be named as explicitly as possible in English.
-The naming convention concerns prefix letters of these name, in order to identify the variable type and status. \\
-Never use a FORTRAN keyword as a routine or variable name. \\
-The table below lists the starting letter(s) to be used for variable naming, depending on their type and status:
-%--------------------------------------------------TABLE--------------------------------------------------
-\begin{table}[htbp]
-  \begin{center}
-    \begin{tabular}{|p{50pt}|p{50pt}|p{50pt}|p{50pt}|p{50pt}|p{50pt}|p{50pt}|}
-      \hline
-      Type \par / Status &   integer&   real&   logical &   character&   double \par precision&   complex \\
-      \hline
-      public  \par or  \par module variable& \textbf{m n} \par \textit{but not } \par \textbf{nn\_}& \textbf{a b e f g h o} \textbf{q} \textit{to} \textbf{x} \par but not \par \textbf{fs rn\_}& \textbf{l} \par \textit{but not} \par \textbf{lp ld ll ln\_}& \textbf{c} \par \textit{but not} \par \textbf{cp cd cl cn\_}& \textbf{d} \par \textit{but not} \par \textbf{dp dd dl dn\_}& \textbf{y} \par \textit{but not} \par \textbf{yp yd yl} \\
-      \hline
-      dummy \par argument& \textbf{k} \par \textit{but not} \par \textbf{kf}& \textbf{p} \par \textit{but not}  \par \textbf{pp pf}& \textbf{ld}& \textbf{cd}& \textbf{dd}& \textbf{yd} \\
-      \hline
-      local \par variable& \textbf{i}& \textbf{z}& \textbf{ll}& \textbf{cl}& \textbf{cd}& \textbf{yl} \\
-      \hline
-      loop \par control& \textbf{j} \par \textit{but not } \par \textbf{jp}& & & & &  \\
-      \hline
-      parameter& \textbf{jp}& \textbf{pp}& \textbf{lp}& \textbf{cp}& \textbf{dp}& \textbf{yp} \\
-      \hline
-      namelist& \textbf{nn\_}& \textbf{rn\_}& \textbf{ln\_}& \textbf{cn\_}& \textbf{dn\_}& \\
-      \hline
-      CPP \par macro& \textbf{kf}& \textbf{sf} \par & & & & \\
-      \hline
-    \end{tabular}
-    \label{tab1}
-  \end{center}
-\end{table}
-%--------------------------------------------------------------------------------------------------------------
-
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\subsection{Operators}
-
-Use of the operators \texttt{<, >, <=, >=, ==, /=} is strongly recommended instead of their deprecated counterparts
-(\texttt{.lt., .gt., .le., .ge., .eq., .ne.}).
-The motivation is readability.
-In general use the notation: \\
-$<Blank><Operator><Blank>$
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\subsection{Pre processor}
-
-Where the use of a language pre-processor is required, it will be the C pre-processor (cpp). \\
-The cpp key is the main feature used, allowing to ignore some useless parts of the code at compilation step. \\
-The advantage is to reduce the memory use; the drawback is that compilation of this part of the code isn't checked. \\
-The cpp key feature should only be used for a few limited options, if it reduces the memory usage.
-In all cases, a logical variable and a FORTRAN \forcode{IF} should be preferred.
-When using a cpp key \textit{key\_optionname},
-a corresponding logical variable \textit{lk\_optionname} should be declared to
-allow FORTRAN \forcode{IF} tests in the code and
-a FORTRAN module with the same name ($i.e.$ \textit{optionname.F90}) should be defined.
-This module is the only place where a \``\#if defined'' command appears, selecting either the whole FORTRAN code or
-a dummy module.
-For example, the TKE vertical physics, the module name is \textit{zdftke.F90},
-the CPP key is \textit{key\_zdftke} and the associated logical is \textit{lk\_zdftke}.
-
-The following syntax:
-
-\begin{forlines}
-#if defined key_optionname
-!! Part of code conditionally compiled if cpp key key_optionname is active
-#endif
-\end{forlines}
-
-Is to be used rather than the \#ifdef abbreviate form since it may have conflicts with some Unix scripts.
-
-Tests on cpp keys included in NEMO at compilation step:
-
-\begin{itemize}
-\item
-  The CPP keys used are compared to the previous list of cpp keys
-  (the compilation will stop if trying to specify a non-existing key)
-\item
-  If a change occurs in the CPP keys used for a given experiment, the whole compilation phase is done again.
-\end{itemize}
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\section{Content rules}
-
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\subsection{Configurations}
-
-The configuration defines the domain and the grid on which NEMO is running.
-It may be useful to associate a cpp key and some variables to a given configuration, although
-the part of the code changed under each of those keys should be minimized.
-As an example, the "ORCA2" configuration (global ocean, 2 degrees grid size) is associated with
-the cpp key \texttt{key\_orca2} for which
-
-\begin{forlines}
-cp_cfg = "orca"
-jp_cfg = 2
-\end{forlines}
-
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\subsection{Constants}
-
-Physical constants ($e.g.$ $\pi$, gas constants) must never be hardwired into the executable portion of a code.
-Instead, a mnemonically named variable or parameter should be set to the appropriate value,
-in the setup routine for the package\index{package}.
-We realize than many parameterizations rely on empirically derived constants or fudge factors,
-which are not easy to name.
-In these cases it is not forbidden to leave such factors coded as "magic numbers" buried in executable code, but
-comments should be included referring to the source of the empirical formula.
-Hard-coded numbers should never be passed through argument lists.
-
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\subsection{Declaration for variables and constants}
-
-\subsubsection{Rules}
-
-Variables used as constants should be declared with attribute \forcode{PARAMETER} and
-used always without copying to local variables, in order to
-prevent from using different values for the same constant or changing it accidentally.
-
-\begin{itemize}
-\item
-  Usage of the \forcode{DIMENSION} statement or attribute is required in declaration statements
-\item
-  The ``::'' notation is quite useful to show that this program unit declaration part is written in
-  standard FORTRAN syntax, even if there are no attributes to clarify the declaration section.
-  Always use the notation $<$blank$>$::$<$three blanks$>$ to improve readability.
-\item
-  Declare the length of a character variable using the \forcode{CHARACTER} (len=xxx) syntax
-  \footnote {
-    The len specifier is important because it is possible to have several kinds for characters
-    ($e.g.$ Unicode using two bytes per character, or there might be a different kind for Japanese $e.g.$ NEC).
-  }
-\item
-  For all global data (in contrast to module data, that is all data that can be access by other module)
-  must be accompanied with a comment field on the same line
-  \footnote {
-    This allows a easy research of where and how a variable is declared using the unix command:
-    ``grep var *90 | grep !:''.
-  }.
-  For example:
-  \begin{forlines}
-  REAL(wp), DIMENSION(jpi,jpj,jpk) ::  ua   ! i-horizontal velocity (m/s)
-  \end{forlines}
-\end{itemize}
-
-\subsubsection{Implicit None}
-
-All subroutines and functions will include an \forcode{IMPLICIT NONE} statement.
-Thus all variables must be explicitly typed.
-It also allows the compiler to detect typographical errors in variable names.
-For modules, one \forcode{IMPLICIT NONE} statement in the modules definition section is needed.
-This also removes the need to have \forcode{IMPLICIT NONE} statements in
-any routines that are \forcode{CONTAINS}'ed in the module.
-Improper data initialisation is another common source of errors
-\footnote{
-  A variable could contain an initial value you did not expect.
-  This can happen for several reasons, $e.g.$ the variable has never been assigned a value, its value is outdated,
-  memory has been allocated for a pointer but you have forgotten to initialise the variable pointed to.
-}.
-To avoid problems, initialise variables as close as possible to where they are first used.
-
-\subsubsection{Attributes}
-
-\forcode{PRIVATE} / \forcode{PUBLIC}:
-All resources of a module are \forcode{PUBLIC} by default.
-A reason to store multiple routines and their data in a single module is that
-the scope of the data defined in the module can be limited to the routines which are in the same module.
-This is accomplished with the \forcode{PRIVATE} attribute. \\
-\forcode{INTENT}:
-All dummy arguments of a routine must include the \forcode{INTENT} clause in their declaration in order to
-improve control of variables in routine calls.
-
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\subsection{Headers}
-
-Prologues are not used in NEMO for now, although it may become an interesting tool in combination with
-ProTeX auto documentation script in the future.
-Rules to code the headers and layout of a module or a routine are illustrated in the example module available with
-the code: \path{./src/OCE/module_example}
-
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\subsection{Interface blocks}
-
-Explicit interface blocks are required between routines if optional or keyword arguments are to be used.
-They also allow the compiler to check that the type, shape and number of arguments specified in the \forcode{CALL}
-are the same as those specified in the subprogram itself.
-FORTRAN 95 compilers can automatically provide explicit interface blocks for routines contained in a module.
-
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\subsection{I/O Error Conditions}
-
-I/O statements which need to check an error condition will use the \texttt{iostat=<integer variable>} construct
-instead of the outmoded \texttt{end=} and \forcode{err=}. \\
-Note that a 0 value means success, a positive value means an error has occurred, and
-a negative value means the end of record or end of file was encountered.
-
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\subsection{PRINT - ASCII output files}
-
-Output listing and errors are directed to \texttt{numout} logical unit =6 and
-produces a file called \textit{ocean.output} (use \texttt{ln\_prt} to have one output per process in MPP).
-Logical \texttt{lwp} variable allows for less verbose outputs.
-To output an error from a routine, one can use the following template:
-
-\begin{forlines}
-IF( nstop /= 0 .AND. lwp ) THEN   ! error print
-   WRITE(numout,cform_err)
-   WRITE(numout,*) nstop, ' error have been found'
-ENDIF
-\end{forlines}
-
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\subsection{Precision}
-
-Parameterizations should not rely on vendor-supplied flags to supply a default floating point precision or
-integer size.
-The F95 \forcode{KIND} feature should be used instead.
-In order to improve portability between 32 and 64 bit platforms,
-it is necessary to make use of kinds by using a specific module \path{./src/OCE/par_kind.F90}
-declaring the "kind definitions" to obtain the required numerical precision and range as well as
-the size of \forcode{INTEGER}.
-It should be noted that numerical constants need to have a suffix of \texttt{\_kindvalue} to
-have the according size. \\
-Thus \forcode{wp} being the "working precision" as declared in \path{./src/OCE/par_kind.F90},
-declaring real array \forcode{zpc} will take the form:
-
-\begin{forlines}
-REAL(wp), DIMENSION(jpi,jpj,jpk) ::  zpc      ! power consumption
-\end{forlines}
-
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\subsection{Structures}
-
-The \forcode{TYPE} structure allowing to declare some variables is more often used in NEMO,
-especially in the modules dealing with reading fields, or interfaces.
-For example:
-
-\begin{forlines}
-! Definition of a tracer as a structure
-TYPE PTRACER
-   CHARACTER(len = 20)  :: sname  ! short name
-   CHARACTER(len = 80 ) :: lname  ! long name
-   CHARACTER(len = 20 ) :: unit   ! unit
-   LOGICAL              :: lini   ! read in a file or not
-   LOGICAL              :: lsav   ! ouput the tracer or not
-END TYPE PTRACER
-
-TYPE(PTRACER) , DIMENSION(jptra) :: tracer
-\end{forlines}
-
-Missing rule on structure name??
-
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\section{Packages coding rules}
-
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\subsection{Bounds checking}
-
-NEMO is able to run when an array bounds checking option is enabled
-(provided the cpp key \texttt{key\_vectopt\_loop} is not defined). \\
-Thus, constructs of the following form are disallowed:
-
-\begin{forlines}
-REAL(wp) :: arr(1)
-\end{forlines}
-
-where "arr" is an input argument into which the user wishes to index beyond 1.
-Use of the (*) construct in array dimensioning is forbidden also because
-it effectively disables array bounds checking.
-
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\subsection{Communication}
-
-A package should refer only to its own modules and subprograms and to those intrinsic functions included in
-the Fortran standard. \\
-All communication with the package will be through the argument list or namelist input.
-\footnote{
-  The point behind this rule is that packages should not have to know details of
-  the surrounding model data structures, or the names of variables outside of the package.
-  A notable exception to this rule is model resolution parameters.
-  The reason for the exception is to allow compile-time array sizing inside the package.
-  This is often important for efficiency.
-}
-
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\subsection{Error conditions}
-
-When an error condition occurs inside a package, a message describing what went wrong will be printed
-(see PRINT - ASCII output files).
-The name of the routine in which the error occurred must be included.
-It is acceptable to terminate execution within a package, but
-the developer may instead wish to return an error flag through the argument list,
-see \textit{stpctl.F90}.
-
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\subsection{Memory management}
-
-The main action is to identify and declare which arrays are \forcode{PUBLIC} and which are \forcode{PRIVATE}. \\
-As of version 3.3.1 of NEMO, the use of static arrays (size fixed at compile time) has been deprecated.
-All module arrays are now declared \forcode{ALLOCATABLE} and
-allocated in either the \texttt{<module\_name>\_alloc()} or \texttt{<module\_name>\_init()} routines.
-The success or otherwise of each \forcode{ALLOCATE} must be checked using
-the \texttt{stat=<integer\ variable>} optional argument. \\
-
-In addition to arrays contained within modules, many routines in NEMO require local, ``workspace'' arrays to
-hold the intermediate results of calculations.
-In previous versions of NEMO, these arrays were declared in such a way as to be automatically allocated on
-the stack when the routine was called.
-An example of an automatic array is:
-
-\begin{forlines}
-SUBROUTINE sub(n)
-   REAL :: a(n)
-   ...
-END SUBROUTINE sub
-\end{forlines}
-
-The downside of this approach is that the program will crash if it runs out of stack space and
-the reason for the crash might not be obvious to the user.
-
-Therefore, as of version 3.3.1, the use of automatic arrays is deprecated.
-Instead, a new module, \textit{wrk\_nemo.F90}, has been introduced which
-contains 1-,2-,3- and 4-dimensional workspace arrays for use in subroutines.
-These workspace arrays should be used in preference to declaring new, local (allocatable) arrays whenever possible.
-The only exceptions to this are when workspace arrays with lower bounds other than 1 and/or
-with extent(s) greater than those in the \textit{wrk\_nemo.F90} module are required. \\
-
-The 2D, 3D and 4D workspace arrays in \textit{wrk\_nemo.F90} have extents \texttt{jpi}, \texttt{jpj},
-\texttt{jpk} and \texttt{jpts} ($x$, $y$, $z$ and tracers) in the first, second, third and fourth dimensions,
-respectively.
-The 1D arrays are allocated with extent MAX($jpi \times jpj, jpk \times jpj, jpi \times jpk$). \\
-
-The \forcode{REAL (KIND = wp)} workspace arrays in \textit{wrk\_nemo.F90}
-are named $e.g.$ \texttt{wrk\_1d\_1, wrk\_4d\_2} etc. and
-should be accessed by USE'ing the \textit{wrk\_nemo.F90} module.
-Since these arrays are available to any routine,
-some care must be taken that a given workspace array is not already being used somewhere up the call stack.
-To help with this, \textit{wrk\_nemo.F90} also contains some utility routines;
-\texttt{wrk\_in\_use()} and \texttt{wrk\_not\_released()}.
-The former first checks that the requested arrays are not already in use and then sets internal flags to show that
-they are now in use.
-The \texttt{wrk\_not\_released()} routine un-sets those internal flags.
-A subroutine using this functionality for two, 3D workspace arrays named \texttt{zwrk1} and
-\texttt{zwrk2} will look something like:
-
-\begin{forlines}
-SUBROUTINE sub()
-   USE wrk_nemo, ONLY: wrk_in_use, wrk_not_released
-   USE wrk_nemo, ONLY: zwrk1 => wrk_3d_5, zwrk2 => wrk_3d_6
-   !
-   IF(wrk_in_use(3, 5,6)THEN
-      CALL ctl_stop('sub: requested workspace arrays unavailable.')
-      RETURN
-   END IF
-   ...
-   ...
-   IF(wrk_not_released(3, 5,6)THEN
-      CALL ctl_stop('sub: failed to release workspace arrays.')
-   END IF
-   !
-END SUBROUTINE sub
-\end{forlines}
-
-The first argument to each of the utility routines is the dimensionality of the required workspace (1--4).
-Following this there must be one or more integers identifying which workspaces are to be used/released.
-Note that, in the interests of keeping the code as simple as possible,
-there is no use of \forcode{POINTER}s etc. in the \textit{wrk\_nemo.F90} module.
-Therefore it is the responsibility of the developer to ensure that the arguments to \texttt{wrk\_in\_use()} and
-\texttt{wrk\_not\_released()} match the workspace arrays actually being used by the subroutine. \\
-
-If a workspace array is required that has extent(s) less than those of the arrays in
-the \textit{wrk\_nemo.F90} module then the advantages of implicit loops and bounds checking may be retained by
-defining a pointer to a sub-array as follows:
-
-\begin{forlines}
-SUBROUTINE sub()
-   USE wrk_nemo, ONLY: wrk_in_use, wrk_not_released
-   USE wrk_nemo, ONLY: wrk_3d_5
-   !
-   REAL(wp), DIMENSION(:,:,:), POINTER :: zwrk1
-   !
-   IF(wrk_in_use(3, 5)THEN
-      CALL ctl_stop('sub: requested workspace arrays unavailable.')
-      RETURN
-   END IF
-   !
-   zwrk1 => wrk_3d_5(1:10,1:10,1:10)
-   ...
-END SUBROUTINE sub
-\end{forlines}
-
-Here, instead of ``use associating'' the variable \texttt{zwrk1} with the array \texttt{wrk\_3d\_5}
-(as in the first example), it is explicitly declared as a pointer to a 3D array.
-It is then associated with a sub-array of \texttt{wrk\_3d\_5} once the call to
-\texttt{wrk\_in\_use()} has completed successfully.
-Note that in F95 (to which NEMO conforms) it is not possible for either the upper or lower array bounds of
-the pointer object to differ from those of the target array. \\
-
-In addition to the \forcode{REAL (KIND = wp)} workspace arrays,
-\textit{wrk\_nemo.F90} also contains 2D integer arrays and 2D REAL arrays with extent (\texttt{jpi}, \texttt{jpk}),
-$i.e.$ $xz$.
-The utility routines for the integer workspaces are \texttt{iwrk\_in\_use()} and \texttt{iwrk\_not\_released()} while
-those for the $xz$ workspaces are \texttt{wrk\_in\_use\_xz()} and \texttt{wrk\_not\_released\_xz()}.
-
-Should a call to one of the \texttt{wrk\_in\_use()} family of utilities fail,
-an error message is printed along with a table showing which of the workspace arrays are currently in use.
-This should enable the developer to choose alternatives for use in the subroutine being worked on. \\
-
-When compiling NEMO for production runs,
-the calls to {\texttt{wrk\_in\_use()} / \texttt{wrk\_not\_released()} can be reduced to stubs that just
-return \forcode{.false.} by setting the cpp key \texttt{key\_no\_workspace\_check}.
-These stubs may then be inlined (and thus effectively removed altogether) by setting appropriate compiler flags
-($e.g.$ ``-finline'' for the Intel compiler or ``-Q'' for the IBM compiler).
-
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\subsection{Optimisation}
-
-Considering the new computer architecture, optimisation cannot be considered independently from the computer type.
-In NEMO, portability is a priority, before any too specific optimisation.
-
-Some tools are available to help: for vector computers, \texttt{key\_vectopt\_loop} allows to unroll a loop
-
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\subsection{Package attribute: \forcode{PRIVATE}, \forcode{PUBLIC}, \forcode{USE}, \forcode{ONLY}}
-
-Module variables and routines should be encapsulated by using the \forcode{PRIVATE} attribute.
-What shall be used outside the module can be declared \forcode{PUBLIC} instead.
-Use \forcode{USE} with the \forcode{ONLY} attribute to specify which of the variables, type definitions etc...
-defined in a module are to be made available to the using routine.
-
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\subsection {Parallelism using MPI}
-
-NEMO is written in order to be able to run on one processor, or on one or more using MPI
-($i.e.$ activating the cpp key $key\_mpp\_mpi$).
-The domain decomposition divides the global domain in cubes (see NEMO reference manual).
-Whilst coding a new development, the MPI compatibility has to be taken in account
-(see \path{./src/LBC/lib_mpp.F90}) and should be tested.
-By default, the $x$-$z$ part of the decomposition is chosen to be as square as possible.
-However, this may be overriden by specifying the number of subdomains in latitude and longitude in
-the \texttt{nammpp} section of the namelist file.
-
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\section{Features to be avoided}
-
-The code must follow the current standards of FORTRAN and ANSI C.
-In particular, the code should not produce any WARNING at compiling phase, so that
-users can be easily alerted of potential bugs when some appear in their new developments.
-Below is a list of features to avoid:
-\begin{itemize}
-\item
-  \forcode{COMMON} block
-  (use the declaration part of \forcode{MODULE} instead)
-\item
-  \forcode{EQUIVALENCE}
-  (use \forcode{POINTER} or derived data type instead to form data structure)
-\item
-  Assigned and computed \forcode{GOTO}
-  (use the \forcode{CASE} construct instead)
-\item
-  Arithmetic \forcode{IF} statement
-  (use the block \forcode{IF}, \forcode{ELSE}, \forcode{ELSEIF}, \forcode{ENDIF} or
-  \forcode{SELECT CASE} construct instead)
-\item
-  Labeled \forcode{DO} construct
-  (use unlabeled \forcode{END DO} instead)
-\item
-  \forcode{FORMAT} statement
-  (use character parameters or
-  explicit format- specifiers inside the \forcode{READ} or \forcode{WRITE} statement instead)
-\item
-  \forcode{GOTO} and \forcode{CONTINUE} statements
-  (use \forcode{IF}, \forcode{CASE}, \forcode{DO WHILE}, \forcode{EXIT} or \forcode{CYCLE} statements or
-  a contained ?)
-\item
-  \forcode{PAUSE}
-\item
-  \forcode{ENTRY} statement: a subprogram must only have one entry point.
-\item
-  \forcode{RETURN} is obsolete and so not necessary at the end of program units
-\item
-  \forcode{FUNCTION} statement
-\item
-  Avoid functions with side effects.
-  \footnote{
-    First, the code is easier to understand, if you can rely on
-    the rule that functions don't change their arguments.
-    Second, some compilers generate more efficient code for PURE functions
-    (in FORTRAN 95 there are the attributes PURE and ELEMENTAL), because
-    they can store the arguments in different places.
-    This is especially important on massive parallel and as well on vector machines.
-  }
-\item
-  \forcode{DATA} and \forcode{BLOCK DATA}
-  (use initialisers)
-\end{itemize}
-
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-
-% \printindex
-% \input NEMO_coding.conv.ind
-
-\end{document}
Index: NEMO/branches/2019/fix_vvl_ticket1791/doc/latex/NEMO/main/NEMO_manual.bib
===================================================================
--- NEMO/branches/2019/fix_vvl_ticket1791/doc/latex/NEMO/main/NEMO_manual.bib	(revision 10999)
+++ 	(revision )
@@ -1,3913 +1,0 @@
-@STRING{AP = {Academic Press}}
-
-@STRING{AREPS = {Annual Review of Earth Planetary Science}}
-
-@STRING{ARFM = {Annual Review of Fluid Mechanics}}
-
-@STRING{ASL = {Atmospheric Science Letters}}
-
-@STRING{AW = {Addison-Wesley}}
-
-@STRING{CP = {Clarendon Press}}
-
-@STRING{CD = {Clim. Dyn.}}
-
-@STRING{CUP = {Cambridge University Press}}
-
-@STRING{CSR = {Cont. Shelf Res.}}
-
-@STRING{D = {Dover Publications}}
-
-@STRING{DAO = {Dyn. Atmos. Ocean}}
-
-@STRING{DSR = {Deep-Sea Res.}}
-
-@STRING{E = {Eyrolles}}
-
-@STRING{EFM ={Environ. Fluid Mech.}}
-
-@STRING{GRL = {Geophys. Res. Let.}}
-
-@STRING{I = {Interscience}}
-
-@STRING{JAOT = {J. Atmos. Ocean Tech.}}
-
-@STRING{JAS = {J. Atmos. Sc.}}
-
-@STRING{JC = {J. Climate}}
-
-@STRING{JCP = {J. Comput. Phys.}}
-
-@STRING{JFM = {J. Fluid Mech.}}
-
-@STRING{JGR = {J. Geophys. Res}}
-
-@STRING{JHUP = {The Johns Hopkins University Press}}
-
-@STRING{JMR = {J. Mar. Res.}}
-
-@STRING{JMS = {J. Mar. Sys.}}
-
-@STRING{JMSJ = {J. Met. Soc. Japan}}
-
-@STRING{JPO = {J. Phys. Oceanogr.}}
-
-@STRING{JSC = {J. Supercomputing.}}
-
-@STRING{JWS = {John Wiley and Sons}}
-
-@STRING{M = {Macmillan}}
-
-@STRING{MGH = {McGraw-Hill}}
-
-@STRING{MWR = {Mon. Wea. Rev.}}
-
-@STRING{Nature = {Nat.}}
-
-@STRING{NH = {North-Holland}}
-
-@STRING{Ocean = {Oceanology}}
-
-@STRING{OD = {Ocean Dyn.}}
-
-@STRING{OM = {Ocean Modelling}}
-
-@STRING{OS = {Ocean Sc.}}
-
-@STRING{OUP = {Oxford University Press}}
-
-@STRING{PH = {Prentice-Hall}}
-
-@STRING{PO = {Prog. Oceangr.}}
-
-@STRING{PP = {Pergamon Press}}
-
-@STRING{PRSL = {Proceedings of the Royal Society of London}}
-
-@STRING{QJRMS = {Quart. J. Roy. Meteor. Soc.}}
-
-@STRING{Recherche = {La Recherche}}
-
-@STRING{RGSP = {Rev. Geophys. Space Phys.}}
-
-@STRING{Science = {Science}}
-
-@STRING{SV = {Springer-Verlag}}
-
-@STRING{Tellus = {Tellus}}
-
-%% No dash for repeated names
-@IEEEtranBSTCTL{IEEEexample:BSTcontrol,
-  CTLdash_repeated_names = "no"
-}
-
-@ARTICLE{Adcroft_Campin_OM04,
-  author =       {A. Adcroft and J.-M. Campin},
-  title =        {Re-scaled height coordinates for accurate
-                  representation of free-surface flows in ocean
-                  circulation models},
-  journal =      OM,
-  year =         2004,
-  volume =       7,
-  pages =        {269--284},
-  doi =          {10.1016/j.ocemod.2003.09.003},
-}
-
-@ARTICLE{Arakawa1966,
-  author =       {A. Arakawa},
-  title =        {Computational design for long term numerical
-                  integration of the equations of fluid motion,
-                  two-dimensional incompressible flow, Part. I.},
-  journal =      JCP,
-  year =         1966,
-  volume =       {I},
-  pages =        {119--149}
-}
-
-@ARTICLE{Arakawa_Hsu_MWR90,
-  author =       {A. Arakawa and Y.-J. G. Hsu},
-  title =        {Energy Conserving and Potential-Enstrophy
-                  Dissipating Schemes for the Shallow Water Equations},
-  journal =      MWR,
-  year =         1990,
-  volume =       118,
-  number =       10,
-  pages =        {1960--1969},
-}
-
-@ARTICLE{Arakawa_Lamb_MWR81,
-  author =       {Arakawa, Akio and Lamb, Vivian R.},
-  title =        {A Potential Enstrophy and Energy Conserving Scheme
-                  for the Shallow Water Equations},
-  journal =      MWR,
-  year =         1981,
-  volume =       109,
-  number =       1,
-  pages =        {18--36}
-}
-
-@ARTICLE{Arbic2004,
-  author =       {B. Arbic and S. Garner and R. Hallberg and
-                  H. Simmons},
-  title =        {The accuracy of surface elevations in forward global
-                  barotropic and baroclinic tide models},
-  journal =      DSR,
-  year =         2004,
-  volume =       51,
-  pages =        {3069-3101}
-}
-
-@ARTICLE{Arbic2010,
-  author =       {Arbic, Wallcraft, Metzger},
-  title =        {Concurrent simulation of the eddying general
-                  circulation and tides in a global ocean model},
-  journal =      OM,
-  year =         2010,
-  volume =       32,
-  number =       {3-4},
-  pages =        {175-187}
-}
-
-@ARTICLE{Arhan2006,
-  author =       {M. Arhan and A.M. Treguier and B. Bourles and
-                  S. Michel},
-  title =        {Diagnosing the annual cycle of the Equatorial
-                  Undercurrent in the Atlantic Ocean from a general
-                  circulation model},
-  journal =      JPO,
-  year =         2006,
-  volume =       36,
-  pages =        {1502--1522}
-}
-
-@ARTICLE{Artale_al_JGR02,
-  author =       {V. Artale and D. Iudicone and R. Santoleri and
-                  V. Rupolo and S. Marullo and F. {D'O}rtenzio},
-  title =        {Role of surface fluxes in ocean general circulation
-                  models using satellite sea surface temperature:
-                  Validation of and sensitivity to the forcing
-                  frequency of the Mediterranean thermohaline
-                  circulation},
-  journal =      JGR,
-  year =         2002,
-  volume =       107,
-  pages =        {1978-2012},
-  doi =          {10.1029/2000JC000452},
-}
-
-@ARTICLE{ASSELIN_MWR72,
-  author =       {R. Asselin},
-  title =        {Frequency Filter for Time Integrations},
-  journal =      MWR,
-  year =         1972,
-  volume =       100,
-  number =       6,
-  pages =        {487--490}
-}
-
-@ARTICLE{Atmadipoera_al_DSR09,
-  author =       {A. Atmadipoera and R. Molcard and G. Madec and
-                  S.Wijffels and J.  Sprintall and A. Koch-Larrouy and
-                  I. Jaya and A. Supangat},
-  title =        {Characteristics and Variability of the Indonesian
-                  Throughflow Water at the Outflow Straits},
-  journal =      DSR,
-  year =         2009,
-  volume =       56,
-  number =       11,
-  pages =        {1942--1954},
-  doi =          {10.1016/j.dsr.2009.06.004},
-}
-
-@ARTICLE{Aumont_al_GBC99,
-  author =       {O. Aumont and P. Monfray and J. C. Orr and G. Madec
-                  and E. Maier-Reimer},
-  title =        {Nutrient trapping in the equatorial Pacific: The
-                  ocean circulation solution},
-  journal =      GBC,
-  year =         1999,
-  volume =       13,
-  pages =        {351--369}
-}
-
-@ARTICLE{Aumont_al_CD98,
-  author =       {O. Aumont and J.C. Orr and D. Jamous and P. Monfray
-                  and O. Marti and G. Madec},
-  title =        {A degradation approach to accelerate simulations to
-                  steady state in a 3-D tracer transport model of the
-                  global ocean},
-  journal =      CD,
-  year =         1998,
-  volume =       14,
-  pages =        {101--116}
-}
-
-@ARTICLE{Axell_JGR02,
-  author =       {L. B. Axell},
-  title =        {Wind-driven internal waves and Langmuir circulations
-                  in a numerical ocean model of the southern Baltic
-                  Sea},
-  journal =      JGR,
-  year =         2002,
-  volume =       107,
-  doi =          {10.1029/2001JC000922},
-}
-
-@ARTICLE{Axell_Liungman_EFM01,
-  author =       {L. B. Axell and O. Liungman},
-  title =        {A one-equation turbulence model for geophysical
-                  applications: Comparison with data and the
-                  k-$\epsilon$ model},
-  journal =      EFM,
-  year =         2001,
-  volume =       1,
-  pages =        {71--106},
-  doi =          {10.1029/2001JC000922},
-}
-
-@ARTICLE{Ayina_al_JC06,
-  author =       {L.-H. Ayina and A. Bentamy and A. Munes-Mestaz and
-                  G. Madec},
-  title =        {The Impact of Satellite Winds and Latent Heat Fluxes
-                  in a Numerical Simulation of the Tropical Pacific
-                  Ocean},
-  journal =      JC,
-  year =         2006,
-  volume =       19,
-  pages =        {5889--5902}
-}
-
-@ARTICLE{Barnier_al_OD06,
-  author =       {B. Barnier and G. Madec and T. Penduff and
-                  J.-M. Molines and A.-M.  Treguier and J. Le Sommer
-                  and A. Beckmann and A. Biastoch and C. Boning and
-                  J. Dengg and C. Derval and E. Durand and S. Gulev
-                  and E. Remy and C. Talandier and S. Theetten and
-                  M. Maltrud and J. McClean and B. De Cuevas},
-  title =        {Impact of partial steps and momentum advection
-                  schemes in a global ocean circulation model at
-                  eddy-permitting resolution.},
-  journal =      OD,
-  year =         2006,
-  volume =       56,
-  pages =        {543--567},
-  doi =          {10.1007/s10236-006-0082-1},
-}
-
-@INCOLLECTION{Barnier1996,
-  author =       {B. Barnier and P. Marchesiello and A.P. de Miranda},
-  title =        {Modeling the ocean circulation in the South
-                  Atlantic: A strategy for dealing with open
-                  boundaries},
-  booktitle =    {The South Atlantic: Present and Past Circulation},
-  publisher =    {Springer-Verlag, Berlin},
-  year =         1996,
-  editor =       {G.Wefer and W.H. Berger and G Siedler and D. Webb},
-  pages =        {289-304}
-}
-
-@ARTICLE{Barnier1998,
-  author =       {B. Barnier and P. Marchesiello and A. P. de Miranda
-                  and J.M. Molines and M. Coulibaly},
-  title =        {A sigma-coordinate primitive equation model for
-                  studying the circulation in the South Atlantic I,
-                  Model configuration with error estimates},
-  journal =      DSR,
-  year =         1998,
-  volume =       45,
-  pages =        {543--572}
-}
-
-@ARTICLE{Barthelet_al_CRAS98,
-  author =       {P. Barthelet and S. Bony and P. Braconnot and
-                  A. Braum and D. Cariolle and E. Cohen-Solal and
-                  J.-L. Dufresne and P. Delecluse and M. D\'{e}qu\'{e}
-                  and L. Fairhead and M.-A. Filiberti and M. Forichon
-                  and J.-Y. Grandpeix and E. Guilyardi and
-                  M.-N. Houssais and M. Imbard and H. Le Treut and
-                  C. Lévy and Z.X. Li and G. Madec and P. Marquet and
-                  O. Marti and S. Planton and L. Terray and O. Thual
-                  and S. Valcke},
-  title =        {Global coupled simulations of climate change due to
-                  increased atmospheric CO2 concentration},
-  journal =      {C. R. Acad. Sci Paris},
-  year =         1998,
-  volume =       326,
-  pages =        {677--684}
-}
-
-@ARTICLE{Beckmann2003,
-  author =       {A. Beckmann and H. Goosse},
-  title =        {A parameterization of ice shelf-ocean interaction
-                  for climate models},
-  journal =      OM,
-  year =         2003,
-  volume =       5,
-  pages =        {157--170}
-}
-
-@ARTICLE{Beckmann1998,
-  author =       {A. Beckmann},
-  title =        {The representation of bottom boundary layer
-                  processes in numerical ocean circulation models.},
-  journal =      {Ocean modelling and parameterization,
-                  E. P. Chassignet and J. Verron (eds.), NATO Science
-                  Series, Kluwer Academic Publishers},
-  year =         1998
-}
-
-@ARTICLE{Beckmann_Doscher1997,
-  author =       {A. Beckmann and R. D\"{o}scher},
-  title =        {A method for improved representation of dense water
-                  spreading over topography in geopotential-coordinate
-                  models},
-  journal =      JPO,
-  year =         1997,
-  volume =       27,
-  pages =        {581--591}
-}
-
-@ARTICLE{Beckmann1993,
-  author =       {A. Beckmann and D. B. Haidvogel},
-  title =        {Numerical Simulation of Flow around a Tall Isolated
-                  Seamount.  Part I - Problem Formulation and Model
-                  Accuracy},
-  journal =      JPO,
-  year =         1993,
-  volume =       23,
-  number =       8,
-  pages =        {1736--1753}
-}
-
-@ARTICLE{Bernie_al_CD07,
-  author =       {D. Bernie and E. Guilyardi and G. Madec and
-                  J. M. Slingo and S. J. Woolnough},
-  title =        {Impact of resolving the diurnal cycle in an
-                  ocean--atmosphere GCM. Part 1: a diurnally forced
-                  OGCM},
-  journal =      CD,
-  year =         2007,
-  volume =       29,
-  number =       6,
-  pages =        {575--590}
-}
-
-@ARTICLE{Bernie_al_CD08,
-  author =       {D. Bernie and E. Guilyardi and G. Madec and
-                  J. M. Slingo and S. J. Woolnough},
-  title =        {Impact of resolving the diurnal cycle in an
-                  ocean--atmosphere GCM. Part 2: A diurnally coupled
-                  CGCM},
-  journal =      CD,
-  year =         2008,
-  volume =       31,
-  number =       7,
-  pages =        {909--925},
-  doi =          {10.1007/s00382-008-0429-z},
-}
-
-@ARTICLE{Bernie_al_JC05,
-  author =       {D. J. Bernie and S. J. Woolnough and J. M. Slingo
-                  and E. Guilyardi},
-  title =        {Modelling diurnal and intraseasonal variability of
-                  the ocean mixed layer},
-  journal =      JC,
-  year =         2005,
-  volume =       18,
-  number =       8,
-  pages =        {1190--1200}
-}
-
-@ARTICLE{Bessiere_al_GRL08,
-  author =       {L. Bessi\'{e}res and G. Madec and F. Lyard},
-  title =        {Global Tidal Residual Mean Circulation: Does it
-                  Affect a Climate OGCM?},
-  journal =      GRL,
-  year =         2008,
-  volume =       35,
-  pages =        {L03609},
-  doi =          {10.1029/2007GL032644},
-}
-
-@ARTICLE{Biastoch_al_JC08,
-  author =       {A. Biastoch and C. W. Böning and J. Getzlaff and
-                  J.-M. Molines and G. Madec},
-  title =        {Causes of interannual – decadal variability in the
-                  meridional overturning circulation of the
-                  mid-latitude North Atlantic Ocean},
-  journal =      JC,
-  year =         2008,
-  volume =       21,
-  number =       24,
-  pages =        {6599-6615},
-  doi =          {10.1175/2008JCLI2404.1},
-}
-
-@ARTICLE{Bignami_al_JGR95,
-  author =       {F. Bignami and S. Marullo and R. Santoleri and
-                  M. E. Schiano},
-  title =        {Longwave radiation budget in the Mediterranean Sea},
-  journal =      JGR,
-  year =         1995,
-  volume =       100,
-  number =       {C2},
-  pages =        {2501--2514},
-  doi =          {10.1029/94JC02496},
-}
-
-@ARTICLE{Blanke_al_JPO99,
-  author =       {B. Blanke and M. Arhan and G. Madec and S. Roche},
-  title =        {Warm Water Paths in the Equatorial Atlantic as
-                  Diagnosed with a General Circulation Model},
-  journal =      JPO,
-  year =         1999,
-  volume =       29,
-  number =       11,
-  pages =        {2753-2768}
-}
-
-@ARTICLE{Blanke1993,
-  author =       {B. Blanke and P. Delecluse},
-  title =        {Low frequency variability of the tropical Atlantic
-                  ocean simulated by a general circulation model with
-                  mixed layer physics},
-  journal =      JPO,
-  year =         1993,
-  volume =       23,
-  pages =        {1363--1388}
-}
-
-@ARTICLE{blanke_al_JC97,
-  author =       {B. Blanke and J. D. Neelin and D. Gutzler},
-  title =        {Estimating the effect of stochastic wind forcing on
-                  ENSO irregularity},
-  journal =      JC,
-  year =         1997,
-  volume =       10,
-  pages =        {1473--1486}
-}
-
-@ARTICLE{Blanke_Raynaud_JPO97,
-  author =       {B. Blanke and S. Raynaud},
-  title =        {Kinematics of the Pacific Equatorial Undercurrent:
-                  An Eulerian and Lagrangian Approach from GCM
-                  Results},
-  journal =      JPO,
-  year =         1997,
-  volume =       27,
-  number =       6,
-  pages =        {1038--1053}
-}
-
-@ARTICLE{Blanke_al_JPO01,
-  author =       {B. Blanke and S. Speich and G. Madec and K. Döös},
-  title =        {A global Diagnostic of interocean mass transfers},
-  journal =      JPO,
-  year =         2001,
-  volume =       31,
-  number =       6,
-  pages =        {1623--1632}
-}
-
-@ARTICLE{Blanke_al_GRL02,
-  author =       {B. Blanke and S. Speich and G. Madec and
-                  R. Maug\'{e}},
-  title =        {A global diagnostic of interior ocean ventilation},
-  journal =      GRL,
-  year =         2002,
-  volume =       29,
-  number =       8,
-  pages =        {1081--1084}
-}
-
-@ARTICLE{Blayo2005,
-  author =       {E. Blayo and L. Debreu},
-  title =        {Revisiting open boundary conditions from the point
-                  of view of characteristic variables},
-  journal =      OM,
-  year =         2005,
-  volume =       9,
-  pages =        {231--252}
-}
-
-@ARTICLE{Bloom_al_MWR96,
-  author =       {S. C. Bloom and L. L. Takacs and A. M. Da Silva and
-                  D. Ledvina},
-  title =        {Data assimilation using incremental analysis
-                  updates},
-  journal =      MWR,
-  year =         1996,
-  volume =       124,
-  pages =        {1256--1271}
-}
-
-@ARTICLE{Bopp_al_GBC01,
-  author =       {L. Bopp and P. Monfray and O. Aumont and
-                  J.-L. Dufresne and H. Le Treut and G. Madec and
-                  L. Terray and J.C. Orr},
-  title =        {Potential impact of climate change on marine export
-                  production},
-  journal =      GBC,
-  year =         2001,
-  volume =       15,
-  number =       1,
-  pages =        {81--101}
-}
-
-@article{bouffard_Boegman_DAO2013,
-  author =       {D. Bouffard and L. Boegman},
-  title =        {A diapycnal diffusivity model for stratified
-                  environmental flows},
-  volume =       {61-62},
-  issn =         03770265,
-  doi =          {10.1016/j.dynatmoce.2013.02.002},
-  journal =      DAO,
-  year =         2013,
-  pages =        {14--34},
-}
-
-@ARTICLE{Bougeault1989,
-  author =       {P. Bougeault and P. Lacarrere},
-  title =        {Parameterization of Orography-Induced Turbulence in
-                  a Mesobeta--Scale Model},
-  journal =      MWR,
-  year =         1989,
-  volume =       117,
-  number =       8,
-  pages =        {1872--1890},
-}
-
-@ARTICLE{Bouillon_al_OM09,
-  author =       {S. Bouillon and M.A. Morales Maqueda and V. Legat
-                  and T. Fichefet},
-  title =        {An Elastic-Viscous-Plastic Sea Ice Model formulated
-                  on Arakawa B and C Grids},
-  journal =      OM,
-  year =         2009,
-  volume =       27,
-  pages =        {174--184},
-  doi =          {10.1016/j.ocemod.2009.01.004},
-}
-
-@ARTICLE{Boulanger_al_GRL01,
-  author =       {J.-P. Boulanger and E. Durand and J.-P. Duvel and
-                  C. Menkes and P.  Delecluse and M. Imbard and
-                  M. Lengaigne and G. Madec and S. Masson},
-  title =        {Role of non-linear oceanic processes in the response
-                  to westerly wind events: new implications for the
-                  1997 El Niño onset},
-  journal =      GRL,
-  year =         2001,
-  volume =       28,
-  number =       8,
-  pages =        {1603--1606}
-}
-
-@article{Brankart_OM2013,
-  author =       "J.-M. Brankart",
-  title =        "Impact of uncertainties in the horizontal density
-                  gradient upon low resolution global ocean modelling
-                  ",
-  journal =      OM,
-  year =         2013,
-  volume =       66,
-  pages =        "64--76",
-  issn =         "1463-5003",
-  doi =          "http://dx.doi.org/10.1016/j.ocemod.2013.02.004",
-}
-
-@Article{Brankart_al_GMD2015,
-  AUTHOR =       {Brankart, J.-M. and Candille, G. and Garnier, F. and
-                  Calone, C. and Melet, A. and Bouttier, P.-A. and
-                  Brasseur, P. and Verron, J.},
-  TITLE =        {A generic approach to explicit simulation of
-                  uncertainty in the NEMO ocean model},
-  JOURNAL =      {Geoscientific Model Development},
-  VOLUME =       8,
-  YEAR =         2015,
-  NUMBER =       5,
-  PAGES =        {1285--1297},
-  DOI =          {10.5194/gmd-8-1285-2015}
-}
-
-@ARTICLE{Breivik_al_JPO2014,
-  AUTHOR =       {{\O}yvind Breivik and Peter A.E.M. Janssen and
-                  Jean-Raymond Bidlot},
-  YEAR =         2014,
-  TITLE =        "{Approximate Stokes Drift Profiles in Deep Water}",
-  JOURNAL =      {JPO},
-  VOLUME =       44,
-  NUMBER =       9,
-  DOI =          {10.1175/JPO-D-14-0020.1.},
-  PAGES =        {2433--2445, arXiv:1406.5039}
-}
-
-@ARTICLE{Breivik_al_OM2016,
-  AUTHOR =       {{\O}yvind Breivik and Jean-Raymond Bidlot and Peter
-                  A.E.M. Janssen},
-  YEAR =         2016,
-  TITLE =        "{A Stokes drift approximation based on the Phillips
-                  spectrum}",
-  JOURNAL =      {OM},
-  VOLUME =       100,
-  DOI =          {10.1016/j.ocemod.2016.01.005},
-  PAGES =        {49--56, arXiv:1601.08092}
-}
-
-@ARTICLE{Brodeau_al_OM09,
-  author =       {L. Brodeau and B. Barnier and A.-M. Tr\'{e}guier and
-                  T. Penduff and S. Gulev},
-  title =        {An ERA40-based atmospheric forcing for global ocean
-                  circulation models},
-  journal =      OM,
-  year =         2009,
-  volume =       31,
-  number =       {3-4},
-  pages =        {88--104}
-}
-
-@ARTICLE{de_Boyer_Montegut_al_JGR04,
-  author =       {C. de Boyer Mont\'{e}gut and G. Madec and
-                  A.S. Fischer and A. Lazar and D. Iudicone},
-  title =        {Mixed layer depth over the global ocean: An
-                  examination of profile data and a profile-based
-                  climatology},
-  journal =      JGR,
-  year =         2004,
-  volume =       109,
-  pages =        {C12003},
-  doi =          {10.1029/2004JC002378},
-}
-
-@ARTICLE{de_Boyer_Montegut_al_JC07,
-  author =       {C. de Boyer Mont\'{e}gut and J. Vialard and
-                  F. Durand and G. Madec},
-  title =        {Simulated seasonal and interannual variability of
-                  mixed layer heat budget in the northern Indian
-                  Ocean},
-  journal =      JC,
-  year =         2007,
-  volume =       20,
-  number =       13,
-  pages =        {3249--3268}
-}
-
-@ARTICLE{Brown_Campana_MWR78,
-  author =       {J. A. Brown and K. A. Campana},
-  title =        {An Economical Time-Differencing System for Numerical
-                  Weather Prediction},
-  journal =      MWR,
-  year =         1978,
-  volume =       106,
-  number =       8,
-  pages =        {1125--1136},
-}
-
-@ARTICLE{Bryan1997,
-  author =       {K. Bryan},
-  title =        {A Numerical Method for the Study of the Circulation
-                  of the World Ocean},
-  journal =      JCP,
-  year =         1997,
-  volume =       135,
-  number =       2
-}
-
-@ARTICLE{Bryan1984,
-  author =       {K. Bryan},
-  title =        {Accelerating the convergence to equilibrium of
-                  ocean-climate models},
-  journal =      JPO,
-  year =         1984,
-  volume =       14,
-  pages =        {666--673}
-}
-
-@ARTICLE{Bryden1973,
-  author =       {H. L. Bryden},
-  title =        {New polynomials for thermal expansion, adiabatic
-                  temperature gradient and potential temperature of
-                  sea water},
-  journal =      DSR,
-  year =         1973,
-  volume =       20,
-  pages =        {401--408}
-}
-
-@ARTICLE{Burchard_OM02,
-  author =       {Hans Burchard},
-  title =        {Energy-conserving discretisation of turbulent shear
-                  and buoyancy production},
-  journal =      OM,
-  year =         2002,
-  volume =       4,
-  number =       {3-4},
-  pages =        {347--361},
-  doi =          {10.1016/S1463-5003(02)00009-4},
-}
-
-@ARTICLE{Campin2004,
-  author =       {J.-M. Campin and A. Adcroft and C. Hill and
-                  J. Marshall},
-  title =        {Conservation of properties in a free-surface model},
-  journal =      OM,
-  year =         2004,
-  volume =       6,
-  number =       {3-4},
-  pages =        {221--244}
-}
-
-@ARTICLE{Campin_al_OM08,
-  author =       {J.-M. Campin and J. Marshall and D. Ferreira},
-  title =        {Sea ice-ocean coupling using a rescaled vertical
-                  coordinate z*},
-  journal =      OM,
-  year =         2008,
-  volume =       24,
-  number =       {1-2},
-  pages =        {1--14},
-  doi =          {10.1016/j.ocemod.2008.05.005},
-}
-
-@ARTICLE{Campin_Goosse_Tel99,
-  author =       {J.-M. Campin and H. Goosse},
-  title =        {Parameterization of density-driven downsloping flow
-                  for a coarse-resolution ocean model in z-coordinate},
-  journal =      {Tellus},
-  year =         1999,
-  volume =       51,
-  pages =        {412--430}
-}
-
-@ARTICLE{Carrere_Lyard_GRL03,
-  author =       {L. Carr\`{e}re and F. Lyard},
-  title =        {Modelling the barotropic response of the global
-                  ocean to atmospheric wind and pressure forcing -
-                  comparisons with observations},
-  journal =      GRL,
-  year =         2003,
-  volume =       30,
-  number =       6,
-  doi =          {10.1029/2002GL016473},
-}
-
-@ARTICLE{Castellari_al_JMS1998,
-  author =       {S> Castellari and N. Pinardi and K. Leaman },
-  title =        {A model study of air-sea interactions in the
-                  Mediterranean Sea.},
-  journal =      JMS,
-  year =         1998,
-  volume =       18,
-  pages =        {89--114}
-}
-
-@TECHREPORT{Chanut2005,
-  author =       {J. Chanut},
-  title =        {Nesting code for NEMO},
-  year =         2005,
-  institution =  {European Union: Marine Environment and Security for
-                  the European Area (MERSEA) Integrated Project},
-  note =         {MERSEA-WP09-MERCA-TASK-9.1.1}
-}
-
-@ARTICLE{Chassignet_al_JPO03,
-  author =       {Eric P. Chassignet and Linda T. Smith and George
-                  R. Halliwell},
-  title =        {North Atlantic Simulations with the Hybrid
-                  Coordinate Ocean Model (HYCOM): Impact of the
-                  Vertical Coordinate Choice, Reference Pressure, and
-                  Thermobaricity},
-  journal =      JPO,
-  year =         2003,
-  volume =       33,
-  pages =        {2504-2526}
-}
-
-@ARTICLE{Covey_al_CD00,
-  author =       {C. Covey and A. Abe-Ouchi and G.J. Boer and
-                  B.A. Boville and U. Cubasch and L. Fairhead and
-                  G.M. Flato and H. Gordon and E. Guilyardi and
-                  X. Jiang and T.C. Johns and H. Le Treut and G. Madec
-                  and G.A. Meehl and R. Miller and A. Noda and
-                  S. B. Power and E. Roeckner and G. Russell and
-                  E.K. Schneider and R.J. Stouffer and L. Terray and
-                  J.-S. von Storch},
-  title =        {The seasonal cycle in coupled ocean-atmosphere
-                  general circulation models},
-  journal =      CD,
-  year =         2000,
-  volume =       16,
-  pages =        {775--787}
-}
-
-@ARTICLE{Canuto_2001,
-  author =       {V. M. Canuto and A. Howard and Y. Cheng and
-                  M. S. Dubovikov},
-  title =        {Ocean turbulence. PartI: One-point closure
-                  model-momentum and heat vertical diffusivities},
-  journal =      JPO,
-  year =         2001,
-  volume =       24,
-  number =       12,
-  pages =        {2546--2559}
-}
-
-@ARTICLE{Cox1987,
-  author =       {M. Cox},
-  title =        {Isopycnal diffusion in a z-coordinate ocean model},
-  journal =      OM,
-  year =         1987,
-  volume =       74,
-  pages =        {1--9}
-}
-
-@ARTICLE{Craig_Banner_JPO94,
-  author =       {P. D. Craig and M. L. Banner},
-  title =        {Modeling wave-enhanced turbulence in the ocean
-                  surface layer},
-  journal =      JPO,
-  year =         1994,
-  volume =       24,
-  number =       12,
-  pages =        {2546--2559}
-}
-
-@ARTICLE{Craik_Leibovich_JFM76,
-  author =       {A. D. D. Craik and S. Leibovich},
-  title =        {A rational model for Langmuir circulations},
-  journal =      JFM,
-  year =         1976,
-  volume =       73,
-  pages =        {401--426}
-}
-
-@ARTICLE{Cravatte_al_OM07,
-  author =       {Cravatte, S. and G. Madec and T. Izumo and C. Menkes
-                  and A. Bozec},
-  title =        {Progress in the 3-D circulation of the eastern
-                  equatorial Pacific in a climate ocean model},
-  journal =      OM,
-  year =         2007,
-  volume =       17,
-  number =       1,
-  pages =        {28--48}
-}
-
-@BOOK{Daley_Barker_Bk01,
-  author =       {R. Daley and E. Barker},
-  title =        {NAVDAS Source Book 2001},
-  publisher =    {NRL/PU/7530-01-441, Available from the Naval
-                  Research Laboratory, Monterey, CA., 93943-5502},
-  year =         2001,
-  pages =        {163pp}
-}
-
-@ARTICLE{D'Alessio_al_JPO98,
-  author =       {S. J. D. D'Alessio and K. Abdella and
-                  N. A. McFarlane},
-  title =        {A new second-order turbulence closure scheme for
-                  modeling the oceanic mixed layer},
-  journal =      JPO,
-  year =         1998,
-  volume =       28,
-  pages =        {1624--1641}
-}
-
-@ARTICLE{Danabasoglu_al_2008,
-  author =       {G. Danabasoglu and R. Ferrari and J. C. McWilliams},
-  title =        {Sensitivity of an ocean general circulation model to
-                  a parameterization of near-surface eddy fluxes},
-  volume =       21,
-  year =         2008,
-  doi =          {10.1175/2007JCLI1508.1},
-  journal =      {J. Climate},
-  pages =        {1192--1208},
-}
-
-@ARTICLE{Dandonneau_al_S04,
-  author =       {Y. Dandonneau and C. Menkes and T. Gorgues and
-                  G. Madec},
-  title =        {Reply to Peter Killworth, 2004 : '' Comment on the
-                  Oceanic Rossby Waves acting as a “Hay Rake” for
-                  ecosystem by-products ''},
-  journal =      {Science},
-  year =         2004,
-  volume =       304,
-  pages =        390
-}
-
-@ARTICLE{Davies_QJRMS76,
-  author =       {H.C. Davies},
-  title =        {A lateral boundary formulation for multi-level
-                  prediction models},
-  year =         1976,
-  journal =      QJRMS,
-  volume =       102,
-  pages =        {405--418}
-}
-
-@ARTICLE{Debreu_al_CG2008,
-  author =       {L. Debreu and C. Vouland and E. Blayo},
-  title =        {AGRIF: Adaptive Grid Refinement In Fortran},
-  journal =      {Computers and Geosciences},
-  year =         2008,
-  volume =       34,
-  pages =        {8--13}
-}
-
-@article{de_lavergne_JPO2016_mixing,
-  author =       {C. de Lavergne and G. Madec and J. Le Sommer and
-                  A. J. G. Nurser and A. C. Naveira Garabato },
-  title =        {On Antarctic Bottom Water consumption in the abyssal
-                  ocean},
-  issn =         {0022-3670},
-  doi =          {10.1175/JPO-D-14-0201.1},
-  journal =      {Journal of Physical Oceanography},
-  year =         2016,
-  volume =       46,
-  pages =        {635-–661}
-}
-
-@article{de_lavergne_JPO2016_efficiency,
-  author =       {C. de Lavergne and G. Madec and J. Le Sommer and
-                  A. J. G. Nurser and A. C. Naveira Garabato },
-  title =        {The impact of a variable mixing efficiency on the
-                  abyssal overturning},
-  issn =         {0022-3670},
-  doi =          {10.1175/JPO-D-14-0259.1},
-  journal =      {Journal of Physical Oceanography},
-  year =         2016,
-  volume =       46,
-  pages =        {663-–681}
-}
-
-@ARTICLE{Delecluse_Madec_Bk00,
-  author =       {P. Delecluse and G. Madec},
-  title =        {Ocean modelling and the role of the ocean in the
-                  climate system},
-  journal =      {In \textit{Modeling the Earth's Climate and its
-                  Variability}, Les Houches, Session, LXVII 1997,
-                  Eds. W. R. Holland, S. Joussaume and F. David,
-                  Elsevier Science},
-  year =         2000,
-  pages =        {237--313}
-}
-
-@PHDTHESIS{Demange_PhD2014,
-  author =       {J. Demange},
-  title =        {Sch\'{e}mas num\'{e}riques d'advection et de
-                  propagation d’ondes de gravit\'{e} dans les
-                  mod\`{e}les de circulation oc\'{e}anique.},
-  school =       {Doctorat es Applied Mathematiques, Grenoble
-                  University, France},
-  year =         2014,
-  pages =        {138pp}
-}
-
-@ARTICLE{Dobricic_al_OS07,
-  author =       {S. Dobricic and N. Pinardi and M. Adani and
-                  M. Tonani and C. Fratianni and A. Bonazzi and
-                  V. Fernandez},
-  title =        {Daily oceanographic analysis by the Mediterranean
-                  basin scale assimilation system},
-  journal =      OS,
-  year =         2007,
-  volume =       3,
-  pages =        {149-157}
-}
-
-@ARTICLE{Doney_al_GBC04,
-  author =       {S.C. Doney and K. Lindsay and K. Caldeira and
-                  J.−M. Campin and H.  Drange and J.−C. Dutay and
-                  M. Follows and Y. Gao and A. Gnanadesikan and
-                  N. Gruber and A. Ishida and F. Joos and G. Madec and
-                  E. Maier−Reimer and J.C. Marshall and R.J. Matear
-                  and P. Monfray and A. Mouchet and R. Najjar and
-                  J.C. Orr and G.−K. Plattner and J. Sarmiento and R.
-                  Schlitzer and R. Slater and I.J. Totterdell and
-                  M.−F. Weirig and Y. Yamanaka and A. Yoo},
-  title =        {Evaluating global ocean carbon models: the
-                  importance of realistic physics},
-  journal =      GBC,
-  year =         2004,
-  volume =       18,
-  pages =        {GB3017},
-  doi =          {10.1029/2003GB002150},
-}
-
-@ARTICLE{Dorscher_Beckmann_JAOT00,
-  author =       {R. D\"{o}scher and A. Beckmann},
-  title =        {Effects of a Bottom Boundary Layer Parameterization
-                  in a Coarse-Resolution Model of the North Atlantic
-                  Ocean},
-  journal =      JAOT,
-  year =         2000,
-  volume =       17,
-  pages =        {698--707}
-}
-
-@ARTICLE{Drijfhout_JPO94,
-  author =       {S. S. Drijfhout},
-  title =        {Heat transport by Mesoscale Eddies in an Ocean
-                  Circulation Model},
-  journal =      JPO,
-  year =         1994,
-  volume =       24,
-  pages =        {353--369}
-}
-
-@ARTICLE{Dukowicz1994,
-  author =       {J. K. Dukowicz and R. D. Smith},
-  title =        {Implicit free-surface method for the
-                  Bryan-Cox-Semtner ocean model},
-  journal =      JGR,
-  year =         1994,
-  volume =       99,
-  pages =        {7991--8014}
-}
-
-@ARTICLE{Durand_al_JC07,
-  author =       {F. Durand and D. Shankar and C. de Boyer
-                  Mont\'{e}gut and S.S.C.  Shenoi and B. Blanke and
-                  G. Madec},
-  title =        {Modeling the barrier-layer formation in the
-                  South-Eastern Arabian Sea},
-  journal =      JC,
-  year =         2007,
-  volume =       20,
-  number =       10,
-  pages =        {2109--2120}
-}
-
-@ARTICLE{Durand_al_GRL04,
-  author =       {F. Durand and S. R. Shetye and J. Vialard and
-                  D. Shankar and S.S.C.  Shenoi and C. Eth\'{e} and
-                  G. Madec},
-  title =        {Impact of temperature inversions on SST evolution in
-                  the South−Eastern Arabian Sea during the pre−summer
-                  monsoon season},
-  journal =      GRL,
-  year =         2004,
-  volume =       31,
-  pages =        {L01305},
-  doi =          {10.1029/2003GL018906},
-}
-
-@INCOLLECTION{Durran2001,
-  author =       {D.R. Durran },
-  title =        {Open boundary conditions: fact and fiction},
-  booktitle =    {Advances in Mathematical Modelling of Atmosphere and
-                  Ocean Dynamics},
-  publisher =    {Kluwer Academic Publishers},
-  year =         2001,
-  editor =       {P.F. Hodnett}
-}
-
-@ARTICLE{Dutay_al_OM02,
-  author =       {J.-C. Dutay and J.L. Bullister and S.C. Doney and
-                  J.C. Orr and R.  Najjar and K. Caldeira and
-                  J.-M. Campin and H. Drange and M. Follows and Y. Gao
-                  and N. Gruber and M. W. Hecht and A. Ishida and
-                  F. Joos and K. Lindsay and G. Madec and
-                  E. Maier-Reimer and J.C. Mashall and R. J. Matear
-                  and P. Monfray and G.-K. Plattner and J. Sarmiento
-                  and R. Schlitzer and R. Slater and I.J. Totterdell
-                  and M.-F. Weirig and Y. Yamanaka and A. Tool},
-  title =        {Evaluation of ocean model ventilation with CFC-11:
-                  comparison of 13 global ocean models},
-  journal =      OM,
-  year =         2002,
-  volume =       4,
-  pages =        {89--120}
-}
-
-@ARTICLE{Dutay_al_EFM09,
-  author =       {J.-C. Dutay and J. Emile-Geay and D. Iudicone and
-                  P. Jean-Baptiste and G. Madec and C. Carouge},
-  title =        {Helium Isotopic Constraints on Simulated Ocean
-                  Circulations - Implications for abyssal theories},
-  journal =      EFM,
-  year =         2009,
-  volume =       10,
-  number =       {1-2},
-  pages =        {257--273},
-  doi =          {10.1007/s10652-009-9159-y}
-}
-
-@ARTICLE{Dutay.J.C2004,
-  author =       {J. -C. Dutay and P. J. -Baptiste and J. -M. Campin
-                  and A. Ishida and E. M. -Reimer and R. J. Matear and
-                  A. Mouchet and I. J. Totterdell and Y. Yamanaka and
-                  K. Rodgers and G. Madec and J.C. Orr},
-  title =        {Evaluation of OCMIP-2 ocean models deep
-                  circulation with mantle helium-3},
-  journal =      JMS,
-  year =         2004,
-  pages =        {1--22}
-}
-
-@ARTICLE{D'Ortenzio_al_GRL05,
-  author =       {F. D\'Ortenzio and D. Iudicone and C. de Boyer
-                  Mont\'{e}gut and P.  Testor and D. Antoine and
-                  S. Marullo and R. Santoleri and G. Madec},
-  title =        {Seasonal variability of the mixed layer depth in the
-                  Mediterranean Sea : a new climatology based on
-                  analysis of individual profiles},
-  journal =      GRL,
-  year =         2005,
-  volume =       32,
-  pages =        {L12605},
-  doi =          {10.1029/2005GL022463},
-}
-
-@ARTICLE{Egbert_Ray_JGR01,
-  author =       {G.B. Egbert and R.D. Ray},
-  title =        {Estimates of M2 tidal energy dissipation from
-                  TOPEX/POSEIDON altimeter data},
-  journal =      JGR,
-  year =         2001,
-  volume =       106,
-  pages =        {22475--22502}
-}
-
-@ARTICLE{Egbert_Ray_Nat00,
-  author =       {G.B. Egbert and R.D Ray},
-  title =        {Significant dissipation of tidal energy in the deep
-                  ocean inferred from satellite altimeter data},
-  journal =      {Nature},
-  year =         2000,
-  volume =       405,
-  pages =        {775--778}
-}
-
-@ARTICLE{Eiseman1980,
-  author =       {P. R. Eiseman and A. P. Stone},
-  title =        {Conservation lows of fluid dynamics -- A survey},
-  journal =      {SIAM Review},
-  year =         1980,
-  volume =       22,
-  pages =        {12--27}
-}
-
-@ARTICLE{Emile-Geay_Madec_OS09,
-  author =       {J. Emile-Geay and G. Madec},
-  title =        {Geothermal heating, diapycnal mixing and the abyssal
-                  circulation},
-  journal =      OS,
-  year =         2009,
-  volume =       5,
-  pages =        {281--325}
-}
-
-@ARTICLE{Engerdahl_Tel95,
-  author =       {H. Engerdahl},
-  year =         1995,
-  title =        {Use of the flow relaxation scheme in a
-                  three-dimensional baroclinic ocean model with
-                  realistic topography},
-  journal =      {Tellus},
-  volume =       {47A},
-  pages =        {365--382}
-}
-
-@ARTICLE{EUROMODEL_OA95,
-  author =       {EUROMODEL Group (P.M. Lehucher, L. Beautier,
-                  M. Chartier, F. Martel, L. Mortier, P. Brehmer,
-                  C. Millot, C. Alberola, M. Benzhora,
-                  I. Taupier-Letage, G. Chabert d'Hieres, H. Didelle,
-                  P. Gleizon, D. Obaton, M. Cr\'{e}pon, C. Herbaut,
-                  G. Madec, S. Speich, J. Nihoul, J. M. Beckers,
-                  P. Brasseur, E. Deleersnijder, S. Djenidi, J. Font,
-                  A. Castellon, E. Garcia-Ladona, M. J. Lopez-Garcia,
-                  M. Manriquez, M. Maso, J. Salat, J. Tintore,
-                  S. Alonso, D. Gomis, A. Viudez, M. Astraldi,
-                  D. Bacciola, M. Borghini, F. Dell'amico, C. Galli,
-                  E. Lazzoni, G. P. Gasparini, S. Sparnocchia, and
-                  A. Harzallah)},
-  title =        {Progress from 1989 to 1992 in
-                  understanding the circulation of the Western
-                  Mediterranean Sea.},
-  journal =      {Oceanologica Acta},
-  year =         1995,
-  volume =       18,
-  number =       2,
-  pages =        {255--271}
-}
-
-@PHDTHESIS{Farge1987,
-  author =       {M. Farge},
-  title =        {Dynamique non lineaire des ondes et des tourbillons
-                  dans les equations de Saint Venant},
-  school =       {Doctorat es Mathematiques, Paris VI University,
-                  France},
-  year =         1987,
-  pages =        {401pp}
-}
-
-@ARTICLE{Farrow1995,
-  author =       {D. E. Farrow and D. P. Stevens},
-  title =        {A new tracer advection scheme for Bryan--Cox type
-                  ocean general circulation models},
-  journal =      JPO,
-  year =         1995,
-  volume =       25,
-  pages =        {1731--1741.}
-}
-
-@ARTICLE{Flather1976,
-  author =       {R.A. Flather},
-  year =         1976,
-  title =        {A tidal model of the north-west European continental
-                  shelf},
-  journal =      {Memoires de la Societ\'{e} Royale des Sciences de
-                  Li\`{e}ge},
-  volume =       6,
-  pages =        {141--164}
-}
-
-@ARTICLE{Flather_JPO94,
-  author =       {R.A. Flather},
-  year =         1994,
-  title =        {A storm surge prediction model for the northern Bay
-                  of Bengal with application to the cyclone disaster
-                  in April 1991},
-  journal =      JPO,
-  volume =       24,
-  pages =        {172--190}
-}
-
-@ARTICLE{Fujio1991,
-  author =       {S. Fujio and N. Imasato},
-  title =        {Diagnostic calculation for circulation and water
-                  mass movement in the deep Pacific},
-  journal =      JGR,
-  year =         1991,
-  volume =       96,
-  pages =        {759--774}
-}
-
-@ARTICLE{Galperin_al_JAS88,
-  author =       {B. Galperin and L. H. Kantha and S. Hassid and
-                  A. Rosati},
-  title =        {A quasi-equilibrium turbulent energy model for
-                  geophysical flows},
-  journal =      JAS,
-  year =         1988,
-  volume =       45,
-  pages =        {55--62}
-}
-
-@ARTICLE{Gargett1984,
-  author =       {A. E. Gargett},
-  title =        {Vertical eddy diffusivity in the ocean interior},
-  journal =      JMR,
-  year =         1984,
-  volume =       42
-}
-
-@ARTICLE{Gaspar1990,
-  author =       {P. Gaspar and Y. Gr{\'e}goris and J.-M. Lefevre},
-  title =        {A simple eddy kinetic energy model for simulations
-                  of the oceanic vertical mixing\: Tests at Station
-                  Papa and long-term upper ocean study site},
-  journal =      JGR,
-  year =         1990,
-  volume =       95,
-  number =       {C9}
-}
-
-@ARTICLE{Gent1990,
-  author =       {P. R. Gent and J. C. Mcwilliams},
-  title =        {Isopycnal Mixing in Ocean Circulation Models},
-  journal =      JPO,
-  year =         1990,
-  volume =       20,
-  number =       1,
-  pages =        {150--155},
-}
-
-@Article{Gentemann_al_JGR09,
-  author =       {C. L. Gentemann and P. J. Minnett and B. Ward},
-  title =        {Profiles of Ocean Surface heating ({POSH}): A new
-                  model of upper ocean diurnal warming},
-  journal =      JGR,
-  year =         2009,
-  Volume =       114,
-  Pages =        {C07017},
-  doi =          {10.1029/2008JC004825}
-}
-
-@ARTICLE{Gerdes1993a,
-  author =       {R. Gerdes},
-  title =        {A primitive equation ocean circulation model using a
-                  general vertical coordinate transformation
-                  1. Description and testing of the model},
-  journal =      JGR,
-  year =         1993,
-  volume =       98
-}
-
-@ARTICLE{Gerdes1993b,
-  author =       {R. Gerdes},
-  title =        {A primitive equation ocean circulation model using a
-                  general vertical coordinate transformation
-                  2. Application to an overflow problem},
-  journal =      JGR,
-  year =         1993,
-  volume =       98,
-  pages =        {14703--14726}
-}
-
-@ARTICLE{Gerdes1991,
-  Author =       {Gerdes, R{\"u}diger and K{\"o}berle, Cornelia and
-                  Willebrand, J{\"u}rgen},
-  Doi =          {10.1007/BF00210006},
-  Journal =      {Clim. Dynamics},
-  Number =       4,
-  Pages =        {211--226},
-  Title =        {The influence of numerical advection schemes on the
-                  results of ocean general circulation models},
-  Volume =       5,
-  Year =         1991,
-}
-
-@TECHREPORT{Gibson_TR86,
-  author =       {J. K. Gibson},
-  title =        {Standard software development and maintenance},
-  institution =  {Operational Dep., ECMWF, Reading, UK.},
-  year =         1986
-}
-
-@BOOK{Gill1982,
-  title =        {Atmosphere-Ocean Dynamics},
-  publisher =    {International Geophysics Series, Academic Press,
-                  New-York},
-  year =         1982,
-  author =       {A. E. Gill}
-}
-
-@article{goff_JGR2010,
-  author =       {J. A. Goff},
-  title =        {Global prediction of abyssal hill root-mean-square
-                  heights from small-scale altimetric gravity
-                  variability},
-  issn =         {2156-2202},
-  doi =          {10.1029/2010JB007867},
-  volume =       115,
-  number =       {B12},
-  journal =      {Journal of Geophysical Research: Solid Earth},
-  year =         2010,
-  pages =        {B12104},
-}
-
-@ARTICLE{Goosse_al_JGR99,
-  author =       {H. Goosse and E. Deleersnijder and T. Fichefet and
-                  M. England},
-  title =        {Sensitivity of a global coupled ocean-sea ice model
-                  to the parameterization of vertical mixing},
-  journal =      JGR,
-  year =         1999,
-  volume =       104,
-  pages =        {13,681--13,695}
-}
-
-@ARTICLE{Gorgues_al_GRL07,
-  author =       {T. Gorgues and C. Menkes and O. Aumont and
-                  K. Rodgers and G. Madec and Y. Dandonneau},
-  title =        {Indonesian Throughflow control of the eastern
-                  equatorial Pacific biogeochemistry},
-  journal =      GRL,
-  year =         2007,
-  volume =       34,
-  pages =        {L05609},
-  doi =          {10.1029/2006GL028210},
-}
-
-@ARTICLE{Graham_McDougall_JPO13,
-  author =       {F.S. Graham and T.J. McDougall},
-  title =        {Quantifying the nonconservative production of
-                  conservative temperature, potential temperature, and
-                  entropy},
-  journal =      JPO,
-  year =         2013,
-  volume =       43,
-  pages =        {838--862},
-  doi =          {10.1175/JPO-D-11-0188.1}
-}
-
-@ARTICLE{Greatbatch_JGR94,
-  author =       {R. J. Greatbatch},
-  title =        {A note on the representation of steric sea level in
-                  models that conserve volume rather than mass},
-  journal =      JGR,
-  year =         1994,
-  volume =       99,
-  number =       {C6},
-  pages =        {12,767--12,771}
-}
-
-@BOOK{Griffies_Bk04,
-  title =        {Fundamentals of ocean climate models},
-  publisher =    {Princeton University Press, 434pp},
-  year =         2004,
-  author =       {S.M. Griffies}
-}
-
-@ARTICLE{Griffies_JPO98,
-  author =       {S.M. Griffies},
-  title =        {The Gent-McWilliams skew-flux},
-  journal =      JPO,
-  year =         1998,
-  volume =       28,
-  pages =        {831--841}
-}
-
-@ARTICLE{Griffies_al_OM09,
-  author =       {S.M. Griffies and A. Biastoch and C. Boning and
-                  F. Bryan and G. Danabasoglu and E. P. Chassignet and
-                  M. H. England and R. Gerdes and H. Haak and
-                  R. W. Hallberg and W. Hazeleger and J. Jungclaus and
-                  W. G. Large and G. Madec and A. Pirani and
-                  B. L. Samuels and M. Scheinert and A. Sen Gupta and
-                  C. A. Severijns and H. L. Simmons and A.-M. Treguier
-                  and M. Winton and S. Yeager and J. Yin},
-  title =        {Coordinated Ocean-ice Reference Experiments (COREs)},
-  journal =      OM,
-  year =         2009,
-  volume =       26,
-  number =       {1-2},
-  pages =        {1--46},
-  doi =          {10.1016/j.ocemod.2008.08.007},
-}
-
-@ARTICLE{Griffies_al_OS05,
-  author =       {S.M. Griffies and A. Gnanadesikan and K.W. Dixon and
-                  J.P. Dunne and R. Gerdes and M.J. Harrison and
-                  A. Rosati and J.L. Russell and B.L.  Samuels and
-                  M.J. Spelman and M. Winton and R. Zhang},
-  title =        {Formulation of an ocean model for global climate
-                  simulations},
-  journal =      OS,
-  year =         2005,
-  volume =       1,
-  pages =        {45--79}
-}
-
-@ARTICLE{Griffies_al_JPO98,
-  author =       {S.M. Griffies and A. Gnanadesikan and
-                  R.C. Pacanowski and V.D. Larichev and J.K. Dukowicz
-                  and R.D. Smith},
-  title =        {Isoneutral Diffusion in a z-Coordinate Ocean Model},
-  journal =      JPO,
-  year =         1998,
-  volume =       28,
-  number =       5,
-  pages =        {805--830},
-}
-
-@ARTICLE{Griffies_al_MWR01,
-  author =       {S.M. Griffies and R.C. Pacanowski and M. Schmidt and
-                  V. Balaji},
-  title =        {Tracer Conservation with an Explicit Free Surface
-                  Method for z-Coordinate Ocean Models},
-  journal =      MWR,
-  year =         2001,
-  volume =       129,
-  number =       5,
-  pages =        {1081--1098},
-}
-
-@ARTICLE{Griffies_Hallberg_MWR00,
-  author =       {S.M. Griffies and R.W. Hallberg},
-  title =        {Biharmonic friction with a Smagorinsky-like
-                  viscosity for use in large-scale eddy-permitting
-                  ocean models},
-  journal =      MWR,
-  year =         2000,
-  volume =       128,
-  pages =        {2935–-2946},
-  doi =          {10.1175/1520-0493(2000)128}
-}
-
-@ARTICLE{Guilyardi_al_JC04,
-  author =       {E. Guilyardi and S. Gualdi and J. M. Slingo and
-                  A. Navarra and P. Delecluse and J. Cole and G. Madec
-                  and M. Roberts and M. Latif and L. Terray},
-  title =        {Representing El Ni\~{n}o in coupled ocean-atmosphere
-                  GCMs: the dominant role of the atmospheric
-                  component},
-  journal =      JC,
-  year =         2004,
-  volume =       17,
-  pages =        {4623--4629}
-}
-
-@ARTICLE{Guilyardi_Madec_CD98,
-  author =       {E. Guilyardi and G. Madec},
-  title =        {Performance of the OPA-ARPEGE-T21 global
-                  ocean-atmosphere coupled model},
-  journal =      CD,
-  year =         1997,
-  volume =       13,
-  pages =        {149--165}
-}
-
-@ARTICLE{Guilyardi_al_CD01,
-  author =       {E. Guilyardi and G. Madec and L. Terray},
-  title =        {The role of lateral ocean physics in the upper ocean
-                  thermal balance of a coupled ocean-atmosphere GCM},
-  journal =      CD,
-  year =         2001,
-  volume =       17,
-  pages =        {589--599},
-  number =       8
-}
-
-@ARTICLE{Guilyardi_al_CRAS95,
-  author =       {E. Guilyardi and G. Madec and L. Terray and
-                  M. D\'{e}qu\'{e} and M. Pontaud and M. Imbard and
-                  D. Stephenson and M.-A. Filiberti and D. Cariolle
-                  and P. Delecluse and O. Thual},
-  title =        {Simulation couplée océan-atmosphère de la
-                  variabilité du climat},
-  journal =      {C. R. Acad. Sci Paris},
-  year =         1995,
-  volume =       320,
-  number =       {s\'{e}rie IIa},
-  pages =        {683--690}
-}
-
-@ARTICLE{Guyon_al_EP99,
-  author =       {M. Guyon and G. Madec and F.-X. Roux and M. Imbard},
-  title =        {A Parallel ocean model for high resolution studies},
-  journal =      {Lecture Notes in Computer Science},
-  year =         1999,
-  volume =       {Euro-Par'99},
-  pages =        {603--607}
-}
-
-@ARTICLE{Guyon_al_CalPar99,
-  author =       {M. Guyon and G. Madec and F.-X. Roux and M. Imbard
-                  and C. Herbaut and P. Fronier},
-  title =        {Parallelization of the OPA ocean model},
-  journal =      {Calculateurs Paralleles},
-  year =         1999,
-  volume =       11,
-  number =       4,
-  pages =        {499--517}
-}
-
-@BOOK{Haltiner1980,
-  title =        {Numerical prediction and dynamic meteorology},
-  publisher =    {John Wiley {\&} Sons Eds., second edition},
-  year =         1980,
-  author =       {G. J. Haltiner and R. T. Williams},
-  pages =        {477pp}
-}
-
-@ARTICLE{Haney1991,
-  author =       {R. L. Haney},
-  title =        {On the Pressure Gradient Force over Steep Topography
-                  in Sigma Coordinate Ocean Models},
-  journal =      JPO,
-  year =         1991,
-  volume =       21,
-  number =       4,
-  pages =        {610--619},
-}
-
-@ARTICLE{Hazeleger_Drijfhout_JPO98,
-  author =       {W. Hazeleger and S. S. Drijfhout},
-  title =        {Mode water variability in a model of the subtropical
-                  gyre: response to anomalous forcing},
-  journal =      JPO,
-  year =         1998,
-  volume =       28,
-  pages =        {266--288},
-}
-
-@ARTICLE{Hazeleger_Drijfhout_JPO99,
-  author =       {W. Hazeleger and S. S. Drijfhout},
-  title =        {Stochastically forced mode water variability},
-  journal =      JPO,
-  year =         1999,
-  volume =       29,
-  pages =        {1772--1786},
-}
-
-@ARTICLE{Hazeleger_Drijfhout_JGR00,
-  author =       {W. Hazeleger and S. S. Drijfhout},
-  title =        {A model study on internally generated variability in
-                  subtropical mode water formation},
-  journal =      JGR,
-  year =         2000,
-  volume =       105,
-  pages =        {13,965--13,979},
-}
-
-@ARTICLE{Hazeleger_Drijfhout_JPO00,
-  author =       {W. Hazeleger and S. S. Drijfhout},
-  title =        {Eddy subduction in a model of the subtropical gyre},
-  journal =      JPO,
-  year =         2000,
-  volume =       30,
-  pages =        {677--695},
-}
-
-@ARTICLE{Hellerman_Rosenstein_JPO83,
-  author =       {S. Hellerman and M. Rosenstein },
-  title =        {Normal monthly wind stress over the world ocean with
-                  error estimates},
-  journal =      JPO,
-  year =         1983,
-  volume =       13,
-  pages =        {1093--1104},
-}
-
-@ARTICLE{He_Ding_JSC01,
-  author =       {Y. He and C. H. Q. Ding},
-  title =        {Using Accurate Arithmetics to Improve Numerical
-                  Reproducibility and Stability in Parallel
-                  Applications},
-  journal =      JSC,
-  year =         2001,
-  volume =       18,
-  pages =        {259--277},
-}
-
-@ARTICLE{Hirt_al_JCP74,
-  author =       {C. W. Hirt and A. A. Amsden and J. L. Cook},
-  title =        {An Arbitrary Lagrangian--Eulerian Computing Method
-                  for All Flow Speeds},
-  journal =      JCP,
-  year =         1974,
-  volume =       14,
-  pages =        {227--253}
-}
-
-@ARTICLE{Hofmeister_al_OM09,
-  author =       {R. Hofmeister and H. Burchard and J.-M. Beckers},
-  title =        {Non-uniform adaptive vertical grids for 3D numerical
-                  ocean models},
-  journal =      OM,
-  year =         2009,
-  volume =       33,
-  pages =        {70--86},
-  doi =          {10.1016/j.ocemod.2009.12.003},
-  issn =         {1463-5003},
-}
-
-@ARTICLE{Holland1999,
-  author =       {D. Holland and A. Jenkins},
-  title =        {Modeling Thermodynamic Ice-Ocean Interactions at the
-                  Base of an Ice Shelf},
-  journal =      JPO,
-  year =         1999,
-  volume =       29,
-  pages =        {1787--1800},
-}
-
-@ARTICLE{HollowayOM86,
-  author =       {Greg Holloway},
-  title =        {A Shelf Wave/Topographic Pump Drives Mean Coastal
-                  Circulation (part I)},
-  journal =      OM,
-  year =         1986,
-  volume =       68,
-}
-
-@ARTICLE{HollowayJPO92,
-  author =       {Greg Holloway},
-  title =        {Representing Topographic Stress for Large-Scale
-                  Ocean Models},
-  journal =      JPO,
-  year =         1992,
-  volume =       22,
-  pages =        {1033--1046},
-}
-
-@ARTICLE{HollowayJPO94,
-  author =       {Michael Eby and Greg Holloway},
-  title =        {Sensitivity of a Large-Scale Ocean Model to a
-                  Parameterization of Topographic Stress},
-  journal =      JPO,
-  year =         1994,
-  volume =       24,
-  pages =        {2577--2587},
-}
-
-@ARTICLE{HollowayJGR09,
-  author =       {Greg Holloway and Zeliang Wang},
-  title =        {Representing eddy stress in an Arctic Ocean model},
-  journal =      JGR,
-  year =         2009,
-  doi =          {10.1029/2008JC005169},
-}
-
-@ARTICLE{HollowayOM08,
-  author =       {Mathew Maltrud and Greg Holloway},
-  title =        {Implementing biharmonic neptune in a global eddying
-                  ocean model},
-  journal =      OM,
-  year =         2008,
-  volume =       21,
-  pages =        {22--34},
-}
-
-@ARTICLE{Hordoir_al_CD08,
-  author =       {R. Hordoir and J. Polcher and J.-C. Brun-Cottan and
-                  G. Madec},
-  title =        {Towards a parametrization of river discharges into
-                  ocean general circulation models: a closure through
-                  energy conservation},
-  journal =      CD,
-  year =         2008,
-  volume =       31,
-  number =       {7-8},
-  pages =        {891--908},
-  doi =          {10.1007/s00382-008-0416-4},
-}
-
-@ARTICLE{Hsu1990,
-  author =       {Hsu, Yueh-Jiuan G. and Arakawa, Akio},
-  title =        {Numerical Modeling of the Atmosphere with an
-                  Isentropic Vertical Coordinate},
-  journal =      MWR,
-  year =         1990,
-  volume =       118,
-  number =       10,
-  pages =        {1933--1959},
-}
-
-@ARTICLE{Huang_JPO93,
-  author =       {R.X. Huang},
-  title =        {Real freshwater flux as a natural boundary condition
-                  for the salinity balance and thermohaline
-                  circulation forced by evaporation and precipitation},
-  journal =      JPO,
-  year =         1993,
-  volume =       23,
-  pages =        {2428--2446}
-}
-
-@TECHREPORT{Hunke2008,
-  author =       {E.C. Hunke and W.H. Lipscomb},
-  title =        {CICE: the Los Alamos sea ice model documentation and
-                  software user's manual, Version 4.0},
-  institution =  { Los Alamos National Laboratory, N.M.},
-  publisher =    {LA-CC-06-012, Los Alamos National Laboratory, N.M.},
-  year =         2008
-}
-
-@TechReport{Hunter2006,
-  Title =        {Specification for Test Models of Ice Shelf Cavities},
-  Author =       {J. R. Hunter},
-  Institution =  {Antarctic Climate \& Ecosystems Cooperative Research
-                  Centre Private Bag 80, Hobart, Tasmania 7001},
-  Year =         2006,
-}
-
-@TECHREPORT{TEOS10,
-  author =       {IOC and SCOR and IAPSO},
-  title =        {The international thermodynamic equation of seawater
-                  - 2010: Calculation and use of thermodynamic
-                  properties},
-  institution =  {Intergovernmental Oceanographic Commission},
-  publisher =    {Manuals and Guides No. 56, UNESCO (English)},
-  year =         2010,
-  pages =        {196pp},
-  url =          {http://www.teos-10.org/pubs/TEOS-10_Manual.pdf}
-}
-
-@ARTICLE{Iudicone_al_JPO08b,
-  author =       {D. Iudicone and G. Madec and B. Blanke and
-                  S. Speich},
-  title =        {The role of Southern Ocean surface forcings and
-                  mixing in the global conveyor},
-  journal =      JPO,
-  year =         2008,
-  volume =       38,
-  pages =        {1377--1400}
-}
-
-@ARTICLE{Iudicone_al_JPO08a,
-  author =       {D. Iudicone and G. Madec and T. J. McDougall},
-  title =        {Diagnosing water transformations and the key role of
-                  light penetration},
-  journal =      JPO,
-  year =         2008,
-  volume =       38,
-  pages =        {1357--1376}
-}
-
-@ARTICLE{Iudicone_al_JPO07,
-  author =       {D. Iudicone and K. Rodgers and R. Schopp and
-                  G. Madec},
-  title =        {An Exchange window for the Antarctic Intermediate
-                  Water Injection into the South Pacific},
-  journal =      JPO,
-  year =         2007,
-  volume =       37,
-  pages =        {31--49}
-}
-
-@ARTICLE{Iudicone_al_JPO08c,
-  author =       {D. Iudicone and S. Speich and G. Madec and
-                  B. Blanke},
-  title =        {The global Conveyor Belt in a Southern Ocean
-                  perspective},
-  journal =      JPO,
-  year =         2008,
-  volume =       38,
-  pages =        {1401--1425}
-}
-
-@ARTICLE{Izumo_al_CD10,
-  author =       {T. Izumo and S.Masson and J. Vialard and C. de Boyer
-                  Montegut and S. K. Behera and G. Madec and
-                  K. Takahashi and T. Yamagata},
-  title =        {Interannual variations of low-frequency
-                  Madden-Julian Oscillation in autral summer:
-                  Observations},
-  journal =      CD,
-  year =         2010,
-  volume =       35,
-  number =       4,
-  pages =        {669--683},
-  doi =          {10.1007/s00382-009-0655-z}
-}
-
-@ARTICLE{JackMcD1995,
-  author =       {D. R. Jackett and T. J. McDougall},
-  title =        {Minimal adjustment of hydrographic data to achieve
-                  static stability},
-  journal =      JAOT,
-  year =         1995,
-  volume =       12,
-  pages =        {381--389}
-}
-
-@article{Jackson_Rehmann_JPO2014,
-  author =       {P. R. Jackson and C. R. Rehmann},
-  title =        {Experiments on differential scalar mixing in
-                  turbulence in a sheared, stratified flow},
-  journal =      JPO,
-  volume =       44,
-  issn =         {0022-3670},
-  doi =          {10.1175/JPO-D-14-0027.1},
-  number =       10,
-  year =         2014,
-  pages =        {2661--2680},
-}
-
-@TECHREPORT{Janssen_al_TM13,
-  author =       {P.A.E.M. Janssen and {\O}. Breivik and K. Mogensen
-                  and F. Vitart and M. Balmaseda and J.B. Bidlot and
-                  S. Keeley and M. Leut-becher and L. Magnusson and
-                  F. Molteni},
-  title =        {Air-Sea Interaction and Surface Waves},
-  year =         2013,
-  volume =       712,
-  institution =  {ECMWF},
-}
-
-@ARTICLE{Jayne_St_Laurent_GRL01,
-  author =       {S.R. Jayne and L.C. {St. Laurent}},
-  title =        {Parameterizing tidal disspiation over rough
-                  topography},
-  journal =      GRL,
-  pages =        {811--814}
-}
-
-@ARTICLE{Jenkins1991,
-  author =       {A. Jenkins},
-  title =        {A one-dimensional model of ice shelf-ocean
-                  interaction},
-  journal =      JGR,
-  year =         1991,
-  volume =       96,
-  number =       {C11},
-  pages =        {2298--2312}
-}
-
-@ARTICLE{Jenkins2001,
-  author =       {A. Jenkins},
-  title =        {The Role of Meltwater Advection in the Formulation
-                  of Conservative Boundary Conditions at an Ice-Ocean
-                  Interface},
-  journal =      JPO,
-  year =         2001,
-  volume =       31,
-  pages =        {285--296}
-}
-
-@ARTICLE{Jenkins2010,
-  author =       {A. Jenkins},
-  title =        {observation and parameterization of ablation at the
-                  base of Ronne Ice Shelf, Antarctica},
-  journal =      JPO,
-  year =         2010,
-  volume =       40,
-  number =       10,
-  pages =        {2298--2312}
-}
-
-@BOOK{Jerlov_Bk68,
-  title =        {Optical Oceanography},
-  publisher =    {Elsevier},
-  year =         1968,
-  author =       {N. G. Jerlov},
-  pages =        {194pp}
-}
-
-@ARTICLE{Jones_MWR99,
-  author =       {P. W. Jones},
-  title =        {First- and second-order conservative remapping
-                  schemes for grids in spherical coordinates},
-  journal =      MWR,
-  year =         1999,
-  volume =       127,
-  pages =        {2204--2210}
-}
-
-@BOOK{Jones_Bk01,
-  title =        {A User's Guide for SCRIP: A Spherical Coordinate
-                  Remapping and Interpolation Package. Version 1.4},
-  publisher =    {Los Alamos National Laboratory},
-  year =         2001,
-  author =       {P. W. Jones},
-  pages =        {27pp},
-  url =
-                  {http://climate.lanl.gov/Software/SCRIP/SCRIPusers.pdf}
-}
-
-@TECHREPORT{Jones_1998,
-  title =        {A User's Guide for SCRIP: A Spherical Coordinate
-                  Remapping and Interpolation Package. Version 1.4},
-  institution =  {Los Alamos National Laboratory},
-  year =         1998,
-  author =       {P. W. Jones},
-  url =
-                  {http://climate.lanl.gov/Software/SCRIP/SCRIPusers.pdf}
-}
-
-@ARTICLE{Kantha_Clayson_1994,
-  author =       {L. H. Kantha and C. A. Clayson},
-  title =        {An improved mixed layer model for geophysical
-                  applications},
-  journal =      JGR,
-  year =         1994,
-  volume =       99,
-  pages =        {25,235--25,266}
-}
-
-@ARTICLE{Kantha_Carniel_CSR05,
-  author =       {L. Kantha and S. Carniel},
-  title =        {Comment on ''Generic length-scale equation for
-                  geophysical turbulence models'' by L. Umlauf and
-                  H. Burchard},
-  journal =      JMS,
-  year =         2005,
-  volume =       61,
-  pages =        {693--702}
-}
-
-@ARTICLE{Kasahara_MWR74,
-  author =       {A. Kasahara},
-  title =        {Various vertical coordinate systems used for
-                  numerical weather prediction},
-  journal =      MWR,
-  year =         1974,
-  volume =       102,
-  pages =        {509--522}
-}
-
-@ARTICLE{Killworth_al_JPO91,
-  author =       {P.D. Killworth and D. Stainforth and D.J. Webb and
-                  S.M. Paterson},
-  title =        {The Development of a Free-Surface Bryan-Cox-Semtner
-                  Ocean Model},
-  journal =      JPO,
-  year =         1991,
-  volume =       21,
-  number =       9,
-  pages =        {1333--1348}
-}
-
-@INPROCEEDINGS{Killworth1989,
-  author =       {P. D. Killworth},
-  title =        {On the parameterization of deep convection in ocean
-                  models},
-  booktitle =    {Parameterization of small-scale processes},
-  year =         1989,
-  editor =       {Hawaiian winter workshop},
-  month =        {January 17-20},
-  organization = {University of Hawaii at Manoa}
-}
-
-@ARTICLE{Killworth1992,
-  author =       {P. D. Killworth},
-  title =        {An equivalent-barotropic mode in the fine resolution
-                  Antarctic model},
-  journal =      JPO,
-  year =         1992,
-  volume =       22,
-  pages =        {1379--1387}
-}
-
-@ARTICLE{Koch-Larrouy_al_CD10,
-  author =       {A. Koch-Larrouy and M. Lengaigne and P. Terray and
-                  G. Madec and S. Masson},
-  title =        {Tidal mixing in the Indonesian Seas and its effect
-                  on the tropical climate system},
-  journal =      CD,
-  year =         2010,
-  volume =       34,
-  number =       6,
-  pages =        {891--904},
-  doi =          {10.1007/s00382-009-0642-4},
-}
-
-@ARTICLE{Koch-Larrouy_al_OD08b,
-  author =       {A. Koch-Larrouy and G. Madec and B. Blanke and
-                  R. Molcard},
-  title =        {Water mass transformation along the Indonesian
-                  throughflow in an OGCM},
-  journal =      OD,
-  year =         2008,
-  volume =       58,
-  number =       {3-4},
-  pages =        {289--309},
-  doi =          {10.1007/s10236-008-0155-4},
-}
-
-@ARTICLE{Koch-Larrouy_al_GRL07,
-  author =       {A. Koch-Larrouy and G. Madec and P. Bouruet-Aubertot
-                  and T. Gerkema and L. Bessieres and R. Molcard},
-  title =        {Tidal mixing in the Indonesian Seas and its effect
-                  on the tropical climate system},
-  journal =      GRL,
-  year =         2007,
-  volume =       34,
-  pages =        {L04604},
-  doi =          {10.1029/2006GL028405},
-}
-
-@ARTICLE{Koch-Larrouy_al_OD08a,
-  author =       {A. Koch-Larrouy and G. Madec and D. Iudicone and
-                  A. Atmadipoera and R. Molcard},
-  title =        {Physical processes contributing to the water mass
-                  transformation of the Indonesian Throughflow},
-  journal =      OD,
-  year =         2008,
-  volume =       58,
-  number =       {3-4},
-  pages =        {275--288},
-  doi =          {10.1007/s10236-008-0154-5},
-}
-
-@ARTICLE{Kolmogorov1942,
-  author =       {A. N. Kolmogorov},
-  title =        {The equation of turbulent motion in an
-                  incompressible fluid},
-  journal =      {Izv. Akad. Nauk SSSR, Ser. Fiz.},
-  year =         1942,
-  volume =       6,
-  pages =        {56--58}
-}
-
-@ARTICLE{Kondo1975,
-  author =       {J. Kondo},
-  title =        {Air-sea bulk transfer coefficients in diabatic
-                  conditions},
-  journal =      {Boundary-Layer Meteorol},
-  year =         1975,
-  volume =       9,
-  pages =        {91--112}
-}
-
-@article{Lemarie_OM2012,
-  author =       "F. Lemari\'{e} and L. Debreu and A.F. Shchepetkin
-                  and J.C. McWilliams",
-  title =        "On the stability and accuracy of the harmonic and
-                  biharmonic isoneutral mixing operators in ocean
-                  models ",
-  journal =      OM,
-  year =         2012,
-  volume =       "52–53",
-  pages =        "9--35",
-  issn =         "1463-5003",
-  doi =          "http://dx.doi.org/10.1016/j.ocemod.2012.04.007",
-}
-
-@ARTICLE{Lemarie_OM2015,
-  author =       {F. Lemari\'{e} and L. Debreu and J. Demange and
-                  G. Madec and J.M. Molines and M. Honnorat},
-  title =        {Stability Constraints for Oceanic Numerical Models:
-                  Implications for the Formulation of time and space
-                  Discretizations},
-  journal =      OM,
-  year =         2015,
-  volume =       92,
-  pages =        {124--148},
-  doi =          {10.1016/j.ocemod.2015.06.006},
-}
-
-@ARTICLE{Lermusiaux2001,
-  author =       {P. F. J. Lermusiaux},
-  title =        {Evolving the subspace of three-dimensional
-                  miltiscale ocean variability: Massachusetts Bay},
-  journal =      JMS,
-  year =         2001,
-  volume =       29,
-  pages =        {385--422}
-}
-
-@PHDTHESIS{Levy_PhD96,
-  author =       {M. L\'{e}vy},
-  title =        {Mod\'{e}lisation des processus biog\'{e}ochimiques
-                  en M\'{e}diterran\'{e}e nord-occidentale. Cycle
-                  saisonnier et variabilit\'{e} m\'{e}so\'{e}chelle},
-  school =       {Universit\'{e} Pierre et Marie Curie, Paris, France,
-                  207pp},
-  year =         1996
-}
-
-@ARTICLE{Levy_al_GRL01,
-  author =       {M. L\'{e}vy and A. Estubier and G Madec},
-  title =        {Choice of an advection scheme for biogeochemical
-                  models},
-  journal =      GRL,
-  year =         2001,
-  volume =       28
-}
-
-@ARTICLE{Levy_al_OM10,
-  author =       {M. L\'{e}vy and P. Klein and A.-M. Tr\'{e}guier and
-                  D. Iovino and G. Madec and S. Masson and
-                  T. Takahashi},
-  title =        {Impacts of sub-mesoscale physics on idealized gyres},
-  journal =      OM,
-  year =         2010,
-  volume =       34,
-  number =       {1-2},
-  doi =          {10.1016/j.ocemod.2010.04.001},
-}
-
-@ARTICLE{Levy_al_JMS99,
-  author =       {M. L\'{e}vy and L. M\'{e}mery and G. Madec},
-  title =        {The onset of a bloom after deep winter convection in
-                  the Northwestern Mediterranean Sea: mesoscale
-                  process study with a primitive equation model},
-  journal =      JMS,
-  year =         1999,
-  volume =       16,
-  number =       {1-2},
-  pages =        {7--21}
-}
-
-@ARTICLE{Levy_al_DSR98,
-  author =       {M. L\'{e}vy and L. M\'{e}mery and G. Madec},
-  title =        {The onset of the spring bloom in the MEDOC area:
-                  mesoscale spatial variability},
-  journal =      DSR,
-  year =         1998,
-  volume =       {I},
-  number =       46,
-  pages =        {1137--1160}
-}
-
-@ARTICLE{Levy_al_DSR00,
-  author =       {M. L\'{e}vy and L. M\'{e}mery and G. Madec},
-  title =        {Combined effects of mesoscale processes and
-                  atmospheric high-frequency variability on the spring
-                  bloom in the MEDOC area},
-  journal =      DSR,
-  year =         2000,
-  volume =       47,
-  pages =        {527--531}
-}
-
-@BOOK{Large_Yeager_Rep04,
-  title =        {Diurnal to decadal global forcing for ocean and
-                  sea-ice models: the data sets and flux
-                  climatologies},
-  publisher =    {NCAR Technical Note, NCAR/TN-460+STR, CGD Division
-                  of the National Center for Atmospheric Research},
-  year =         2004,
-  author =       {W. G. Large and S. Yeager}
-}
-
-@ARTICLE{Large_al_RG94,
-  author =       {W. G. Large and J. C. McWilliams and S. C. Doney},
-  title =        {Oceanic vertical mixing - a review and a model with
-                  a nonlocal boundary layer parameterization},
-  journal =      {Reviews of Geophysics},
-  year =         1994,
-  volume =       32,
-  pages =        {363--404},
-  doi =          {10.1029/94RG01872},
-}
-
-@ARTICLE{Latif_al_JC06,
-  author =       {M. Latif and C. Böning and J. Willebrand and
-                  A. Biastoch and J. Dengg and N. Keenlyside and
-                  U. Schweckendiek and G. Madec},
-  title =        {Is the Thermohaline Circulation Changing?},
-  journal =      JC,
-  year =         2006,
-  volume =       19,
-  pages =        {4631--4637}
-}
-
-@PHDTHESIS{Lazar_PhD97,
-  author =       {A. Lazar},
-  title =        {La branche froide de la circulation thermohaline -
-                  sensibilit\'{e} \`{a} la diffusion turbulente dans
-                  un mod\`{e}le de circulation g\'{e}n\'{e}rale
-                  id\'{e}alis\'{e}e},
-  school =       {Universit\'{e} Pierre et Marie Curie, Paris, France,
-                  200pp},
-  year =         1997
-}
-
-@ARTICLE{Lazar_al_JPO99,
-  author =       {A. Lazar and G. Madec and P. Delecluse},
-  title =        {The Deep Interior Downwelling, the Veronis Effect,
-                  and Mesoscale Tracer Transport Parameterizations in
-                  an OGCM},
-  journal =      JPO,
-  year =         1999,
-  volume =       29,
-  number =       11,
-  pages =        {2945--2961},
-}
-
-@ARTICLE{Le_Sommer_al_OM09,
-  author =       {J. {Le Sommer} and T. Penduff and S. Theetten and
-                  G. Madec and B.  Barnier},
-  title =        {How momentum advection schemes influence
-                  current-topography interactions at eddy permitting
-                  resolution},
-  journal =      OM,
-  year =         2009,
-  volume =       29,
-  number =       1,
-  pages =        {1--14},
-  doi =          {10.1016/j.ocemod.2008.11.007},
-}
-
-@PHDTHESIS{Leclair_PhD2010,
-  author =       {M. Leclair},
-  title =        {introduction d'une coordonn\'{e}e verticale
-                  arbitrairement Lagrangienne Eul\'{e}rienne dans le
-                  code NEMO, 180pp.},
-  school =       {Universit\'{e} Pierre and Marie Curie},
-  year =         2010
-}
-
-@ARTICLE{Leclair_Madec_OM09,
-  author =       {M. Leclair and G. Madec},
-  title =        {A conservative leap-frog time stepping method},
-  journal =      OM,
-  year =         2009,
-  volume =       30,
-  number =       {2-3},
-  pages =        {88-94},
-  doi =          {10.1016/j.ocemod.2009.06.006},
-}
-
-@ARTICLE{Leclair_Madec_OM11,
-  author =       {M. Leclair and G. Madec},
-  title =        {$\tilde{z}$-coordinate, an Arbitrary
-                  Lagrangian-Eulerian coordinate separating high and
-                  low frequency},
-  journal =      OM,
-  year =         2011,
-  volume =       37,
-  pages =        {139--152},
-  doi =          {10.1016/j.ocemod.2011.02.001},
-}
-
-@ARTICLE{Lele_JCP1992,
-  author =       {S.K. Lele},
-  title =        {Compact finite difference schemes with spectral-like
-                  resolution},
-  journal =      JCP,
-  year =         1992,
-  volume =       103,
-  pages =        {16--42}
-}
-
-@ARTICLE{Lengaigne_al_JC03,
-  author =       {M. Lengaigne and J.-P. Boulanger and C. Menkes and
-                  G. Madec and P.  Delecluse and E. Guilyardi, and
-                  J. Slingo},
-  title =        {The March 1997 Westerly Wind Event and the onset of
-                  the 1997/98 El Niño: Understanding the role of the
-                  atmospheric},
-  journal =      JC,
-  year =         2003,
-  volume =       16,
-  number =       20,
-  pages =        {3330--3343}
-}
-
-@ARTICLE{Lengaigne_al_JGR02,
-  author =       {M. Lengaigne and J.-P. Boulanger and C. Menkes and
-                  S. Masson and G. Madec and P. Delecluse},
-  title =        {Ocean response to the March 1997 Westerly Wind
-                  Event},
-  journal =      JGR,
-  year =         2002,
-  doi =          {10.1029/2001JC000841},
-}
-
-@ARTICLE{Lengaigne_al_JGR03,
-  author =       {M. Lengaigne and G. Madec and G. Alory and
-                  C. Menkes},
-  title =        {Sensitivity of the tropical Pacific Ocean to
-                  isopycnal diffusion on tracer and dynamics},
-  journal =      JGR,
-  year =         2003,
-  volume =       108,
-  number =       {C11},
-  pages =        3345,
-  doi =          {10.1029/2002JC001704},
-}
-
-@ARTICLE{Lengaigne_al_GRL09,
-  author =       {M. Lengaigne and G. Madec and L. Bopp and C. Menkes
-                  and O. Aumont and P. Cadule},
-  title =        {Bio-physical feedbacks in the Arctic Ocean using an
-                  Earth System model},
-  journal =      GRL,
-  year =         2009,
-  volume =       36,
-  pages =        {L21602},
-  doi =          {10.1029/2009GL040145},
-}
-
-@ARTICLE{Lengaigne_al_CD07,
-  author =       {M. Lengaigne and C. Menkes and O. Aumont and
-                  T. Gorgues and L. Bopp and J.-M. Andr\'{e} G. Madec},
-  title =        {Bio-physical feedbacks on the tropical Pacific
-                  climate in a Coupled General Circulation Model},
-  journal =      CD,
-  year =         2007,
-  volume =       28,
-  pages =        {503--516}
-}
-
-@ARTICLE{Leonard1991,
-  author =       {B. P. Leonard},
-  title =        {The ULTIMATE conservative difference scheme applied
-                  to unsteady one--dimensional advection},
-  journal =      {Computer Methods in Applied Mechanics and
-                  Engineering},
-  year =         1991,
-  pages =        {17--74}
-}
-
-@TECHREPORT{Leonard_Rep88,
-  author =       {B. P. Leonard},
-  title =        {Universal limiter for transient interpolation
-                  modelling of the advective transport equations},
-  institution =  {Technical Memorandum TM-100916 ICOMP-88-11, NASA},
-  year =         1988
-}
-
-@ARTICLE{Leonard1979,
-  author =       {B. P. Leonard},
-  title =        {A stable and accurate convective modelling procedure
-                  based on quadratic upstream interpolation},
-  journal =      {Computer Methods in Applied Mechanics and
-                  Engineering},
-  year =         1979,
-  volume =       19,
-  pages =        {59--98},
-}
-
-@TECHREPORT{Levier2007,
-  author =       {B. Levier and A.-M. Tr\'{e}guier and G. Madec and
-                  V. Garnier},
-  title =        {Free surface and variable volume in the NEMO code},
-  institution =  {MERSEA MERSEA IP report WP09-CNRS-STR-03-1A, 47pp,
-                  available on the NEMO web site},
-  year =         2007
-}
-
-@BOOK{levitus82,
-  title =        {Climatological Atlas of the world ocean},
-  publisher =    {NOAA professional paper No. 13, 174pp},
-  year =         1982,
-  author =       {S Levitus },
-  pages =        {173 pp}
-}
-
-@ARTICLE{Li_al_OM2017
-},
-   AUTHOR = {Q Li and B Fox-Kemper and {\O} Breivik and A Webb},
-   YEAR = {2017},
-   TITLE = {Statistical Models of Global Langmuir Mixing}, 
-   JOURNAL = {OM},
-   VOLUME = {113},
-   ISSUE = {May},
-   PAGES = {95--114},
-   DOI = {10.1016/j.ocemod.2017.03.016}
-}
-
-@ARTICLE{Li_Garrett_JMR93,
-  author =       {M. Li and C. Garrett},
-  title =        {Cell merging and the jet/downwelling ratio in
-                  Langmuir circulation},
-  journal =      JMR,
-  year =         1993,
-  volume =       51,
-  pages =        {737--769}
-}
-
-@ARTICLE{Losch2008,
-  author =       {M. Losch},
-  title =        {Modeling ice shelf cavities in a z coordinate ocean
-                  general circulation model},
-  journal =      JGR,
-  year =         2008,
-  volume =       113,
-  number =       {C13},
-}
-
-@TECHREPORT{Lott1989,
-  author =       {F. Lott and G. Madec},
-  title =        {Implementation of bottom topography in the Ocean
-                  General Circulation Model OPA of the LODYC:
-                  formalism and experiments.},
-  institution =  {LODYC, France, 36pp.},
-  year =         1989,
-  number =       3
-}
-
-@ARTICLE{Lott_al_OM90,
-  author =       {F. Lott and G. Madec and J. Verron},
-  title =        {Topographic experiments in an Ocean General
-                  Circulation Model},
-  journal =      OM,
-  year =         1990,
-  volume =       88,
-  pages =        {1--4}
-}
-
-@ARTICLE{Luo_al_JC05,
-  author =       {J.-J. Luo and S. Masson and E. Roeckner and G. Madec
-                  and T. Yamagata},
-  title =        {Reducing climatology bias in an ocean-atmosphere
-                  CGCM with improved coupling physics},
-  journal =      JC,
-  year =         2005,
-  volume =       18,
-  number =       13,
-  pages =        {2344--2360}
-}
-
-@BOOK{Madec_Bk08,
-  title =        {NEMO ocean engine},
-  publisher =    {Note du P\^ole de mod\'{e}lisation, Institut
-                  Pierre-Simon Laplace (IPSL), France, No 27, ISSN No
-                  1288-1619},
-  year =         2008,
-  author =       {G. Madec}
-}
-
-@BOOK{Madec_HDR01,
-  title =        {Le Cycle des Masses d'Eau Oc\'{e}aniqueset sa
-                  variabilit\'{e} dans le Syst\'{e}me Climatique},
-  year =         2001,
-  author =       {G. Madec},
-  pages =        {63pp.},
-  series =       {Habilitation \'{a} Diriger des Recherches,
-                  Universit\'{e} Pierre et Marie Curie}
-}
-
-@PHDTHESIS{Madec_PhD90,
-  author =       {G. Madec},
-  title =        {La formation d'eau profonde et son impact sur la
-                  circulation r\'{e}gionale en M\'{e}diterran\'{e}e
-                  Occidentale - une approche num\'{e}rique},
-  school =       {Universit\'{e} Pierre et Marie Curie, Paris, France,
-                  194pp.},
-  year =         1990,
-  month =        {2 mai}
-}
-
-@ARTICLE{Madec_al_DAO91,
-  author =       {G. Madec and M. Chartier and M. Cr\'{e}pon},
-  title =        {Effect of thermohaline forcing variability on deep
-                  water formation in the Northwestern Mediterranean
-                  Sea - a high resulution three-dimensional study},
-  journal =      DAO,
-  year =         1991,
-  volume =       15,
-  pages =        {301--332}
-}
-
-@ARTICLE{Madec_al_JPO91,
-  author =       {G. Madec and M. Chartier and P. Delecluse and
-                  M. Cr\'{e}pon},
-  title =        {A three-dimensional numerical study of deep water
-                  formation in the Northwestern Mediterranean Sea .},
-  journal =      JPO,
-  year =         1991,
-  volume =       21,
-  pages =        {1349--1371}
-}
-
-@INBOOK{Madec_Crepon_Bk91,
-  chapter =      {Thermohaline-driven deep water formation in the
-                  Northwestern Mediterranean Sea},
-  pages =        {241--265},
-  title =        {Deep convection and deep water formation in the
-                  oceans},
-  publisher =    {Elsevier Oceanographic Series, P.C. Chu and
-                  J.C. Gascard (Eds.)},
-  year =         1991,
-  author =       {G. Madec and M. Cr\'{e}pon}
-}
-
-@ARTICLE{Madec1997,
-  author =       {G. Madec and P. Delecluse},
-  title =        {The OPA/ARPEGE and OPA/LMD Global Ocean-Atmosphere
-                  Coupled Model},
-  journal =      {Int. WOCE Newsletter},
-  year =         1997,
-  volume =       26,
-  pages =        {12--15}
-}
-
-@TECHREPORT{Madec1998,
-  author =       {G. Madec and P. Delecluse and M. Imbard and C. Levy},
-  title =        {OPA 8 Ocean General Circulation Model - Reference
-                  Manual},
-  institution =  {LODYC/IPSL Note 11},
-  year =         1998
-}
-
-@ARTICLE{Madec_Imbard_CD96,
-  author =       {G Madec and M Imbard},
-  title =        {A global ocean mesh to overcome the north pole
-                  singularity},
-  journal =      CD,
-  year =         1996,
-  volume =       12,
-  pages =        {381--388}
-}
-
-@ARTICLE{Madec_al_JPO96,
-  author =       {G. Madec and F. Lott and P. Delecluse and
-                  M. Cr\'{e}pon},
-  title =        {Large-Scale Preconditioning of Deep-Water Formation
-                  in the Northwestern Mediterranean Sea},
-  journal =      JPO,
-  year =         1996,
-  volume =       26,
-  number =       8,
-  pages =        {1393--1408},
-}
-
-@ARTICLE{Madec_al_OM88,
-  author =       {G. Madec and C. Rahier and M. Chartier},
-  title =        {A comparison of two-dimensional elliptic solvers for
-                  the streamfunction in a multilevel OGCM},
-  journal =      OM,
-  year =         1988,
-  volume =       78,
-  pages =        {1-6}
-}
-
-@ARTICLE{Maes_al_CD98,
-  author =       {C. Maes and P. Delecluse and G. Madec},
-  title =        {Impact of westerly wind bursts on the warm pool of
-                  the TOGA-COARE domain in an OGCM},
-  journal =      CD,
-  year =         1998,
-  volume =       14,
-  pages =        {55--70}
-}
-
-@ARTICLE{Maes_al_MWR97,
-  author =       {C. Maes and G. Madec and P. Delecluse},
-  title =        {Sensitivity of an Equatorial Pacific OGCM to the
-                  lateral diffusion},
-  journal =      MWR,
-  year =         1997,
-  volume =       125,
-  number =       5,
-  pages =        {958--971}
-}
-
-@ARTICLE{Maggiore_al_PCE98,
-  author =       {A. Maggiore and M. Zavatarelli and M. G. Angelucci
-                  and N. Pinardi},
-  title =        {Surface heat and water fluxes in the Adriatic Sea:
-                  seasonal and interannual variability},
-  journal =      {Phys Chem Earth},
-  year =         1998,
-  volume =       23,
-  pages =        {561--567}
-}
-
-@ARTICLE{Maltrud1998,
-  author =       {M. E. Maltrud and R. D. Smith and A. J. Semtner and
-                  R. C. Malone},
-  title =        {Global eddy-resolving ocean simulations driven by
-                  1985-1995 atmospheric winds},
-  journal =      JGR,
-  year =         1998,
-  volume =       103,
-  number =       {C13},
-  pages =        {30,825--30,854}
-}
-
-@ARTICLE{Marchesiello2001,
-  author =       { P. Marchesiello and J. Mc Williams and
-                  A. Shchepetkin },
-  title =        {Open boundary conditions for long-term integrations
-                  of Regional Oceanic Models},
-  journal =      OM,
-  year =         2001,
-  volume =       3,
-  pages =        {1--20}
-}
-
-@ARTICLE{Marsaleix_al_OM08,
-  author =       {P. Marsaleix and F. Auclair and J. W. Floor and
-                  M. J. Herrmann and C. Estournel and I. Pairaud and
-                  C. Ulses},
-  title =        {Energy conservation issues in sigma-coordinate
-                  free-surface ocean models},
-  journal =      OM,
-  year =         2008,
-  volume =       20,
-  number =       1,
-  pages =        {61--89},
-  doi =          {10.1016/j.ocemod.2007.07.005},
-}
-
-@Article{Marsh_GMD2015,
-  AUTHOR =       {R. Marsh and V. O. Ivchenko and N. Skliris and
-                  S. Alderson and G. R. Bigg and G. Madec and
-                  A. T. Blaker and Y. Aksenov and B. Sinha and
-                  A. C. Coward and J. Le Sommer and N. Merino and
-                  V. B. Zalesny},
-  TITLE =        {NEMO-ICB (v1.0): interactive icebergs in the NEMO
-                  ocean model globally configured at eddy-permitting
-                  resolution},
-  JOURNAL =      {Geoscientific Model Development},
-  VOLUME =       8,
-  YEAR =         2015,
-  NUMBER =       5,
-  PAGES =        {1547--1562},
-  DOI =          {10.5194/gmd-8-1547-2015}
-}
-
-@article{Martin_Adcroft_OM10,
-  author =       {T. Martin and A. Adcroft},
-  title =        {Parameterizing the fresh-water flux from land ice to
-                  ocean with interactive icebergs in a coupled climate
-                  model},
-  journal =      OM,
-  year =         2010,
-  volume =       34,
-  number =       {3--4},
-  pages =        {111--124},
-  issn =         {1463-5003},
-  doi =          {10.1016/j.ocemod.2010.05.001},
-}
-
-@BOOK{MIT-GCM_2004,
-  title =        {MIT-gcm User Manual},
-  year =         2004,
-  editor =       {MIT Department of EAPS},
-  author =       {J. Marshall and A. Adcroft and J.-M. Campin and
-                  P. Heimbach and A.  Molod and S. Dutkiewicz and
-                  H. Hill and M. Losch and B. Fox-Kemper and
-                  D. Menemenlis and D. Ferreira and E. Hill and
-                  M. Follows and C. Hill and C. Evangelinos and
-                  G. Forget}
-}
-
-@PHDTHESIS{Marti_PhD92,
-  author =       {O. Marti},
-  title =        {Etude de l'oc\'{e}an mondial : mod\'{e}lisation de
-                  la circulation et du transport de traceurs
-                  anthropog\'{e}niques},
-  school =       {Universit\'{e} Pierre et Marie Curie, Paris, France,
-                  201pp},
-  year =         1992
-}
-
-@ARTICLE{Marti_al_CD10,
-  author =       {O. Marti and P. Braconnot and J.-L. Dufresne and
-                  J. Bellier and R.  Benshila and S. Bony and
-                  P. Brockmann and P. Cadule and A. Caubel and F
-                  Codron and S. Denvil and L. Fairhead and T. Fichefet
-                  and M.-A.  Filiberti and M.-A. Foujols and
-                  P. Friedlingstein and H. Goosse and J.-Y. Grandpeix
-                  and E. Guilyardi and F. Hourdin and G. Krinner and
-                  C. L\'{e}vy and G. Madec and J. Mignot and I. Musat
-                  and D. Swingedouw and C. Talandier},
-  title =        {Key features of the IPSL ocean atmosphere model and
-                  its sensitivity to atmospheric resolution},
-  journal =      CD,
-  year =         2010,
-  volume =       34,
-  number =       1,
-  pages =        {1--26},
-  doi =          {10.1007/s00382-009-0640-6},
-}
-
-@ARTICLE{Marti_al_JGR92,
-  author =       {O. Marti and G. Madec and P. Delecluse},
-  title =        {Comment on "Net diffusivity in ocean general
-                  circulation models with nonuniform grids" by
-                  F. L. Yin and I. Y. Fung},
-  journal =      JGR,
-  year =         1992,
-  volume =       97,
-  pages =        {12,763--12,766}
-}
-
-@INBOOK{Masson_al_Bk08,
-  chapter =      {OPA9 - French experiments on the Earth Simulator and
-                  Teraflop Workbench tunings},
-  pages =        {25-34},
-  title =        {In High Performance computing on Vector System 2007,
-                  Stuttgart, Germany},
-  publisher =    {Springer-Verlag},
-  year =         2008,
-  editor =       {Resch M, Roller S, Lammers P, Furui T, Galle M, Bez
-                  W},
-  author =       {S. Masson and M.-A. Foujols and P. Klein and
-                  G. Madec and L. Hua and M. Levy and H. Sasaki and
-                  K. Takahashi and F. Svensson},
-  doi =          {10.1007/978-3-540-74384-2},
-}
-
-@ARTICLE{Masson_al_GRL05,
-  author =       {S. Masson and J.-J. Luo and G. Madec and J. Vialard
-                  and F. Durand and S. Gualdi and E. Guilyardi and
-                  S. Behera and P. Delecluse and A. Navarra and
-                  T. Yamagata},
-  title =        {Impact of barrier layer on winter-spring variability
-                  of the South-Eastern Arabian Sea},
-  journal =      GRL,
-  year =         2005,
-  volume =       32,
-  pages =        {L07703},
-  doi =          {10.1029/2004GL021980},
-}
-
-@Article{Mathiot2017,
-  AUTHOR =       {Mathiot, P. and Jenkins, A. and Harris, C. and Madec, G.},
-  TITLE =        {Explicit representation and parametrised impacts of under ice shelf seas in the ${z}^{\ast}$ coordinate ocean model NEMO 3.6},
-  JOURNAL =      {Geoscientific Model Development},
-  VOLUME =       {10},
-  YEAR =         {2017},
-  NUMBER =       {7},
-  PAGES =        {2849--2874},
-  URL =          {https://www.geosci-model-dev.net/10/2849/2017/},
-  DOI =          {10.5194/gmd-10-2849-2017}
-}
-
-@ARTICLE{McDougall1987,
-  author =       {T. J. McDougall},
-  title =        {Neutral Surfaces},
-  journal =      JPO,
-  year =         1987,
-  volume =       17,
-  number =       11,
-  pages =        {1950--1964},
-}
-
-@ARTICLE{McDougall_Taylor_JMR84,
-  author =       {T. J. McDougall and J. R. Taylor},
-  title =        {Flux measurements across a finger interface at low
-                  values of the stability ratio},
-  journal =      JMR,
-  year =         1984,
-  volume =       42,
-  pages =        {1--14}
-}
-
-@ARTICLE{Mellor_Blumberg_JPO04,
-  author =       {G. Mellor and A. Blumberg},
-  title =        {Wave Breaking and Ocean Surface Layer Thermal
-                  Response},
-  journal =      JPO,
-  volume =       34,
-  number =       3,
-  pages =        {693--698},
-  year =         2004,
-  doi =          {10.1175/2517.1},
-}
-
-@ARTICLE{Mellor_Yamada_1982,
-  author =       {G. L. Mellor and T. Yamada},
-  title =        {Development of a turbulence closure model for
-                  geophysical fluid problems},
-  journal =      RGSP,
-  year =         1982,
-  volume =       20,
-  pages =        {851--875}
-}
-
-@ARTICLE{Menkes_al_JPO06,
-  author =       {C. Menkes and J. Vialard and S C. Kennan and
-                  J.-P. Boulanger and G. Madec},
-  title =        {A modelling study of the three-dimensional heat
-                  budget of Tropical Instability Waves in the
-                  Equatorial Pacific},
-  journal =      JPO,
-  year =         2006,
-  volume =       36,
-  number =       5,
-  pages =        {847--865}
-}
-
-@ARTICLE{Merryfield1999,
-  author =       {W. J. Merryfield and G. Holloway and A. E. Gargett},
-  title =        {A Global Ocean Model with Double-Diffusive Mixing},
-  journal =      JPO,
-  year =         1999,
-  volume =       29,
-  number =       6,
-  pages =        {1124--1142}
-}
-
-@BOOK{Mesinger_Arakawa_Bk76,
-  title =        {Numerical methods used in Atmospheric models},
-  publisher =    {GARP Publication Series No 17},
-  year =         1976,
-  author =       {F. Mesinger and A. Arakawa}
-}
-
-@ARTICLE{Morel_JGR88,
-  author =       {A. Morel},
-  title =        {Optical modeling of the upper ocean in relation to
-                  its biogenous matter content (Case I waters)},
-  journal =      JGR,
-  year =         1988,
-  volume =       93,
-  pages =        {10,749--10,768}
-}
-
-@ARTICLE{Morel_Berthon_LO89,
-  author =       {A. Morel and J.-F. Berthon},
-  title =        {Surface pigments, algal biomass profiles, and
-                  potential production of the euphotic layer:
-                  Relationships reinvestigated in view of
-                  remote-sensing applications},
-  journal =      {Limnol. Oceanogr.},
-  year =         1989,
-  volume =       {34(8)},
-  pages =        {1545--1562}
-}
-
-@ARTICLE{Morel_Maritorena_JGR01,
-  author =       {A. Morel and S. Maritorena},
-  title =        {Bio-optical properties of oceanic waters: a
-                  reappraisal},
-  journal =      JGR,
-  year =         2001,
-  volume =       106,
-  number =       {C4},
-  pages =        {7163--7180}
-}
-
-@ARTICLE{Moun_al_JPO02,
-  author =       {J.N. Moum and D.R. Caldwell and J.D. Nash and
-                  G.D. Gunderson},
-  title =        {Observations of boundary mixing over the continental
-                  slope},
-  journal =      JPO,
-  year =         2002,
-  volume =       32,
-  number =       7,
-  pages =        {2113--2130}
-}
-
-@ARTICLE{Murray_JCP96,
-  author =       {R. J. Murray},
-  title =        {Explicit Generation of Orthogonal Grids for Ocean
-                  Models},
-  journal =      JCP,
-  year =         1996,
-  volume =       126,
-  number =       2,
-  pages =        {251--273},
-}
-
-@ARTICLE{Oddo_al_OS09,
-  author =       {P. Oddo and M. Adani and N. Pinardi and C. Fratianni
-                  and M. Tonani and D. Pettenuzzo},
-  title =        {A nested Atlantic-Mediterranean Sea general
-                  circulation model for operational forecasting},
-  journal =      OS,
-  year =         2009,
-  volume =       5,
-  pages =        {1--13},
-}
-
-@ARTICLE{Oey06,
-   author =      {Lie-Yauw Oey},
-   title =       {An OGCM with movable land-sea boundaries},
-   journal =     {Ocean Modelling},
-   volume =      "13",
-   number =      "2",
-   pages =       "176 - 195",
-   year =        "2006",
-   issn =        "1463-5003",
-   doi =         "https://doi.org/10.1016/j.ocemod.2006.01.001",
-   url =         "http://www.sciencedirect.com/science/article/pii/S1463500306000084",
-}
-
-@PHDTHESIS{Olivier_PhD01,
-  author =       {F. Olivier},
-  title =        {Etude de l'activit\'{e} biologique et de la
-                  circulation oc\'{e}anique dans un jet
-                  g\'{e}ostrophique: le front Alm\'{e}ria-Oran},
-  school =       {Universit\'{e} Pierre et Marie Curie, Paris, France},
-  year =         2001
-}
-
-@ARTICLE{Osborn_JPO80,
-  author =       {T.R. Osborn},
-  title =        {Estimates of the local rate of vertical diffusion
-                  from dissipation measurements},
-  journal =      JPO,
-  year =         1980,
-  volume =       10,
-  pages =        {83--89}
-}
-
-@ARTICLE{Pacanowski_Philander_JPO81,
-  author =       {R.C. Pacanowski and S.G.H. Philander},
-  title =        {Parameterization of Vertical Mixing in Numerical
-                  Models of Tropical Oceans},
-  journal =      JPO,
-  year =         1981,
-  volume =       11,
-  number =       11,
-  pages =        {1443--1451}
-}
-
-@ARTICLE{Pacanowski_Gnanadesikan_MWR98,
-  author =       {R. C. Pacanowski and A. Gnanadesikan},
-  title =        {Transient response in a z-level ocean model that
-                  resolves topography with partial-cells},
-  journal =      MWR,
-  year =         1998,
-  volume =       126,
-  pages =        {3248--3270}
-}
-
-@ARTICLE{Park_al_JC09,
-  author =       {W. Park and N. Keenlyside and M. Latif and
-                  A. Str\¨{o}h and R. Redler and E. Roeckner and
-                  G. Madec},
-  title =        {Tropical Pacific Climate and its Response to Global
-                  Warming in the Kiel Climate Model},
-  journal =      JC,
-  year =         2009,
-  volume =       22,
-  number =       1,
-  pages =        {71--92},
-  doi =          {10.1175/2008JCLI2261.1},
-}
-
-@ARTICLE{Paulson1977,
-  author =       {C. A. Paulson and J. J. Simpson},
-  title =        {Irradiance Measurements in the Upper Ocean},
-  journal =      JPO,
-  year =         1977,
-  volume =       7,
-  number =       6,
-  pages =        {952--956}
-}
-
-@ARTICLE{Payne_JAS72,
-  author =       {R. E. Payne},
-  title =        {Albedo of the Sea Surface},
-  journal =      JAS,
-  year =         1972,
-  volume =       29,
-  pages =        {959--970}
-}
-
-@ARTICLE{Penduff_al_OM06,
-  author =       {T. Penduff and B. Barnier and J.-M. Molines and
-                  G. Madec},
-  title =        {On the use of current meter data to assess the
-                  realism of ocean model simulations},
-  journal =      OM,
-  year =         2006,
-  volume =       11,
-  number =       {3--4},
-  pages =        {399--416}
-}
-
-@ARTICLE{Penduff_al_JGR00,
-  author =       {T. Penduff and B. Barnier and A. Colin de
-                  Verdi\`{e}re},
-  title =        {Self-adapting open boundaries for a regional model
-                  of the eastern North Atlantic},
-  journal =      JGR,
-  year =         2000,
-  volume =       105,
-  pages =        {11,279--11,297}
-}
-
-@ARTICLE{Penduff_al_OS07,
-  author =       {T. Penduff and J. Le Sommer and B. Barnier and
-                  A.M. Treguier and J. Molines and G. Madec},
-  title =        {Influence of numerical schemes on current-topography
-                  interactions in 1/4$^{\circ}$ global ocean
-                  simulations},
-  journal =      OS,
-  year =         2007,
-  volume =       3,
-  pages =        {509--524}
-}
-
-@ARTICLE{Phillips1959,
-  author =       {R. S. Phillips},
-  title =        {Dissipative Operators and Hyperbolic Systems of
-                  Partial Differential Equations},
-  journal =      {Transactions of the American Mathematical Society},
-  year =         1959,
-  volume =       90,
-  number =       2,
-  pages =        {193--254},
-  doi =          {10.2307/1993202},
-}
-
-@ARTICLE{Le_Quere_al_GBC00,
-  author =       {C. Le Qu\'{e}r\'{e} and J. C. Orr and P. Monfray and
-                  O. Aumont and G. Madec},
-  title =        {Interannual variability of the global and regional
-                  sea-air flux of C02 from 1979 to 1993},
-  journal =      GBC,
-  year =         2000,
-  volume =       14,
-  pages =        {1247--1266}
-}
-
-@ARTICLE{Raynaud_al_GRL00,
-  author =       {S. Raynaud and S. Speich and E. Guilyardi and
-                  G. Madec},
-  title =        {Impact of the ocean lateral diffusion on the
-                  ENSO-like variability of a global coupled GCM},
-  journal =      GRL,
-  year =         2000,
-  volume =       27,
-  number =       19,
-  pages =        {3041--3044}
-}
-
-@ARTICLE{Redi_JPO82,
-  author =       {M. H. Redi},
-  title =        {Oceanic isopycnal mixing by coordinate rotation},
-  journal =      JPO,
-  year =         1982,
-  volume =       13,
-  pages =        {1154--1158}
-}
-
-@ARTICLE{Reed_JPO77,
-  author =       {R. K. Reed},
-  title =        {On estimating insolation over the ocean},
-  journal =      JPO,
-  year =         1977,
-  volume =       1,
-  pages =        {874--971}
-}
-
-@ARTICLE{Reverdin1991,
-  author =       {G. Reverdin and P. Delecluse and C. L\'{e}vy and
-                  P. Andrich and A. Morli\`{e}re and J. M. Verstraete},
-  title =        {The near surface tropical Atlantic in 1982-1984 :
-                  results from a numerical simulation and a data
-                  analysis},
-  journal =      PO,
-  year =         1991,
-  volume =       27,
-  pages =        {273--340}
-}
-
-@BOOK{Richtmyer1967,
-  title =        {Difference methods for initial-value problems},
-  publisher =    {Interscience Publisher, Second Edition},
-  year =         1967,
-  author =       {R. D. Richtmyer and K. W. Morton},
-  pages =        {405pp}
-}
-
-@ARTICLE{Robert_JMSJ66,
-  author =       {A. J. Robert},
-  title =        {The integration of a Low order spectral form of the
-                  primitive meteorological equations},
-  journal =      JMSJ,
-  year =         1966,
-  volume =       44,
-  number =       2
-}
-
-@ARTICLE{Rodgers_al_GRL04,
-  author =       {K. Rodgers and O. Aumont and G. Madec and C. Menkes},
-  title =        {Radiocarbon as a thermocline proxy for the eastern
-                  equatorial Pacific},
-  journal =      GRL,
-  year =         2004,
-  volume =       31,
-  pages =        {L14314},
-  doi =          {10.1029/2004GL019764},
-}
-
-@ARTICLE{Rodgers_al_GRL03,
-  author =       {K. Rodgers and B. Blanke and G. Madec and O. Aumont
-                  and P. Ciais and J.-C. Dutay},
-  title =        {Extratropical sources of equatorial pacific
-                  upwelling in an OGCM},
-  journal =      GRL,
-  year =         2003,
-  volume =       30,
-  number =       2,
-  doi =          {10.1029/2002GL016003},
-}
-
-@Article{Rodgers_2014,
-  AUTHOR =       {Rodgers, K. B. and Aumont, O. and Mikaloff Fletcher,
-                  S. E. and Plancherel, Y. and Bopp, L. and de Boyer
-                  Mont\'egut, C. and Iudicone, D. and Keeling,
-                  R. F. and Madec, G. and Wanninkhof, R.},
-  TITLE =        {Strong sensitivity of Southern Ocean carbon uptake
-                  and nutrient cycling to wind stirring},
-  JOURNAL =      {Biogeosciences},
-  VOLUME =       11,
-  YEAR =         2014,
-  NUMBER =       15,
-  PAGES =        {4077--4098},
-  DOI =          {10.5194/bg-11-4077-2014}
-}
-
-@ARTICLE{Rodi_1987,
-  author =       {W. Rodi},
-  title =        {Examples of calculation methods for flow and mixing
-                  in stratified fluids},
-  journal =      JGR,
-  year =         1987,
-  volume =       92,
-  number =       {C5},
-  pages =        {5305--5328}
-}
-
-@INCOLLECTION{Roed1986,
-  author =       {L.P. Roed and C.K. Cooper},
-  title =        {Open boundary conditions in numerical ocean models},
-  booktitle =    {Advanced Physical Oceanography Numerical Modelling},
-  publisher =    { NATO ASI Series, vol. 186.},
-  year =         1986,
-  editor =       {J.J. O'Brien}
-}
-
-@article{Roquet_OM2015,
-  author =       "F. Roquet and G. Madec and T.J. McDougall and
-                  P.M. Barker",
-  title =        "Accurate polynomial expressions for the density and
-                  specific volume of seawater using the TEOS-10
-                  standard ",
-  journal =      OM,
-  volume =       90,
-  pages =        "29--43",
-  year =         2015,
-  issn =         "1463-5003",
-  doi =          "10.1016/j.ocemod.2015.04.002",
-}
-
-@article{Roquet_JPO2015,
-  author =       "F. Roquet and G. Madec and L. Brodeau and
-                  J. Nycander",
-  title =        "Defining a Simplified Yet Realistic Equation of
-                  State for Seawater",
-  journal =      JPO,
-  volume =       45,
-  pages =        "2564--2579",
-  year =         2015,
-  doi =          "10.1175/JPO-D-15-0080.1",
-}
-
-@ARTICLE{Roullet_Madec_JGR00,
-  author =       {G. Roullet and G. Madec},
-  title =        {salt conservation, free surface, and varying levels:
-                  a new formulation for ocean general circulation
-                  models},
-  journal =      JGR,
-  year =         2000,
-  volume =       105,
-  pages =        {23,927--23,942}
-}
-
-@ARTICLE{Rousset_GMD2015,
-  author =       {C. Rousset and M. Vancoppenolle and G. Madec and
-                  T. Fichefet and S. Flavoni and A. Barth\'{e}lemy and
-                  R. Benshila and J. Chanut and C. L\'{e}vy and
-                  S. Masson and F. Vivier },
-  title =        {The Louvain-La-Neuve sea-ice model LIM3.6: Global
-                  and regional capabilities},
-  journal =      {Geoscientific Model Development},
-  year =         2015,
-  volume =       8,
-  pages =        {2991--3005},
-  doi =          {10.5194/gmd-8-2991-2015},
-}
-
-@ARTICLE{Sadourny1975,
-  author =       {R. Sadourny},
-  title =        {The Dynamics of Finite-Difference Models of the
-                  Shallow-Water Equations},
-  journal =      JAS,
-  year =         1975,
-  volume =       32,
-  number =       4,
-  pages =        {680--689},
-}
-
-@ARTICLE{Sarmiento1982,
-  author =       {J. L. Sarmiento and K. Bryan},
-  title =        {Ocean transport model for the North Atlantic},
-  journal =      JGR,
-  year =         1982,
-  volume =       87,
-  pages =        {394--409}
-}
-
-@ARTICLE{Saunders_JAS82,
-  author =       {P. M. Saunders},
-  title =        {{The Temperature at the Ocean-air Interface}},
-  journal =      JAS,
-  year =         1967,
-  volume =       24,
-  pages =        {269-273},
-  doi =          {10.1175/1520-0469(1967)024<0269:TTATOA>2.0.CO;2},
-}
-
-@BOOK{Shchepetkin_McWilliams_Bk08,
-  author =       {A. F. Shchepetkin and J. C. McWilliams},
-  title =        {Handbook of Numerical Analysis, Vol. XIV:
-                  Computational Methods for the Ocean and the
-                  Atmosphere, pp 121-183},
-  publisher =    {P. G. Ciarlet, editor, R. Temam and J. Tribbia,
-                  guest eds., Elsevier Science},
-  year =         2008,
-  pages =        784
-}
-
-@ARTICLE{Shchepetkin_McWilliams_OM05,
-  author =       {A. F. Shchepetkin and J. C. McWilliams},
-  title =        {The regional oceanic modeling system (ROMS) - a
-                  split-explicit, free-surface,
-                  topography-following-coordinate oceanic modelr},
-  journal =      OM,
-  year =         2005,
-  volume =       9,
-  number =       4,
-  pages =        {347--404}
-}
-
-@ARTICLE{Sacha2003,
-  author =       {A. F. Shchepetkin and J. C. McWilliams},
-  title =        {A method for computing horizontal pressure-gradient
-                  force in an oceanic model with a nonaligned vertical
-                  coordinate},
-  journal =      JGR,
-  year =         2003,
-  volume =       108,
-  number =       {C3},
-  pages =        3090,
-  doi =          {10.1029/2001JC001047},
-}
-
-@ARTICLE{Shchepetkin1996,
-  author =       {A. F. Shchepetkin and J. J. O'Brien},
-  title =        {A Physically Consistent Formulation of Lateral
-                  Friction in Shallow-Water Equation Ocean Models},
-  journal =      MWR,
-  year =         1996,
-  volume =       124,
-  number =       6,
-  pages =        {1285--1300}
-}
-
-@ARTICLE{Siddorn_Furner_OM12,
-  author =       {J. Siddorn and R. Furner},
-  title =        {An analytical stretching function that combines the
-                  best attributes of geopotential and
-                  terrain-following vertical coordinates},
-  journal =      OM,
-  year =         2012,
-  pages =        {submitted},
-}
-
-@ARTICLE{Simmons_al_OM04,
-  author =       {H. L. Simmons and S. R. Jayne and
-                  L. C. {St. Laurent} and A. J. Weaver},
-  title =        {Tidally driven mixing in a numerical model of the
-                  ocean general circulation},
-  journal =      OM,
-  year =         2004,
-  pages =        {245--263},
-}
-
-@INBOOK{Smagorinsky_93,
-  author =       {Smagorinsky, J.},
-  chapter =      {Some historical remarks on the use of non-linear
-                  viscosities},
-  title =        {Large Eddy Simulation of Complex Engineering and
-                  Geophysical Flows},
-  pages =        {3--36},
-  year =         1993,
-  publisher =    {Cambridge University Press, B. Galperin and
-                  S. A. Orszag (eds.)},
-}
-
-@ARTICLE{Song_Haidvogel_JCP94,
-  author =       {Y. Song and D. Haidvogel},
-  title =        {A semi-implicit ocean circulation model using a
-                  generalized topography-following coordinate system},
-  journal =      JCP,
-  year =         1994,
-  volume =       115,
-  number =       1,
-  pages =        {228--244}
-}
-
-@ARTICLE{Song1998,
-  author =       {Y. T. Song},
-  title =        {A General Pressure Gradient Formulation for Ocean
-                  Models. Part I: Scheme Design and Diagnostic
-                  Analysis},
-  journal =      MWR,
-  year =         1998,
-  volume =       126,
-  number =       12,
-  pages =        {3213--3230}
-}
-
-@ARTICLE{SongWright1998,
-  author =       {Y. T. Song and D. G. Wright},
-  title =        {A General Pressure Gradient Formulation for Ocean
-                  Models.  Part II: Energy, Momentum, and Bottom
-                  Torque Consistency},
-  journal =      MWR,
-  year =         1998,
-  volume =       126,
-  number =       12,
-  pages =        {3231--3247}
-}
-
-@ARTICLE{Speer_al_Tel00,
-  author =       {K. Speer and E. Guilyardi and G. Madec},
-  title =        {Southern Ocean transformation in a coupled model
-                  with and without eddy mass fluxes},
-  journal =      {Tellus},
-  year =         2000,
-  volume =       {52A},
-  number =       5,
-  pages =        {554--565}
-}
-
-@PHDTHESIS{Speich_PhD92,
-  author =       {S. Speich},
-  title =        {Etude du for\c{c}age de la circulation
-                  g\'{e}n\'{e}rale oc\'{e}anique par les d\'{e}troits
-                  - cas de la mer d'Alboran},
-  school =       {Universit\'{e} Pierre et Marie Curie, Paris, France},
-  year =         1992
-}
-
-@ARTICLE{Speich_al_GRL01,
-  author =       {S. Speich and B. Blanke and G. Madec},
-  title =        {Warm and cold water paths of an OGCM thermohaline
-                  conveyor belt},
-  journal =      GRL,
-  year =         2001,
-  volume =       28,
-  number =       2,
-  pages =        {311--314}
-}
-
-@ARTICLE{Speich_al_JPO96,
-  author =       {S. Speich and G. Madec and M. Cr\'{e}pon},
-  title =        {The circulation in the Alboran Sea - a sensitivity
-                  study},
-  journal =      JPO,
-  year =         1996,
-  volume =       26,
-  number =       3,
-  pages =        {320--340}
-}
-
-@ARTICLE{St_Laurent_Garrett_JPO02,
-  author =       {L.C. {St. Laurent} and C. Garrett},
-  title =        {The role of internal tides in mixing the deep ocean},
-  journal =      JPO,
-  pages =        {2882--2899}
-}
-
-@ARTICLE{St_Laurent_Nash_DSR04,
-  author =       {L.C. {St. Laurent} and J. D. Nash},
-  title =        {An examination of the radiative and dissipative
-                  properties of deep ocean internal tides},
-  journal =      DSR,
-  year =         2004,
-  volume =       {II},
-  number =       51,
-  pages =        {3029--3042},
-  doi =          {10.1016/j.dsr2.2004.09.008},
-}
-
-@ARTICLE{St_Laurent_al_GRL02,
-  author =       {L.C. {St. Laurent} and H.L. Simmons and S.R. Jayne},
-  title =        {Estimating tidally driven mixing in the deep ocean},
-  journal =      GRL,
-  year =         2002,
-  volume =       29,
-  pages =        2106,
-  doi =          {10.1029/2002GL015633},
-}
-
-@ARTICLE{Stacey_JPO99,
-  author =       {M. W. Stacey},
-  title =        {Simulations of the wind-forced near-surface
-                  circulation in Knight Inlet: A parameterization of
-                  the roughness length},
-  journal =      JPO,
-  year =         1999,
-  volume =       29,
-  pages =        {1363--1367},
-}
-
-@ARTICLE{Steele2001,
-  author =       {M. Steele and R. Morley and W. Ermold},
-  title =        {PHC- A Global Ocean Hydrography with a High-Quality
-                  Arctic Ocean},
-  journal =      JC,
-  year =         2001,
-  volume =       14,
-  number =       9,
-  pages =        {2079--2087},
-}
-
-@ARTICLE{Stein_Stein_Nat92,
-  author =       {C. A. Stein and S. Stein},
-  title =        {A model for the global variation in oceanic depth
-                  and heat flow with lithospheric age},
-  journal =      {Nature},
-  year =         1992,
-  volume =       359,
-  pages =        {123--129}
-}
-
-@INCOLLECTION{Stokes_1847,
-  author =       {G.G. Stokes},
-  title =        {On the theory of oscillatory waves},
-  booktitle =    {Transactions of the Cambridge Philosophy Society},
-  year =         1847,
-  volume =       8,
-  Pages =        {441--455}
-}
-
-@ARTICLE{Takaya_al_JGR10,
-  author =       {Y. Takaya and J-R. Bidlot and A. C. M. Beljaars and
-                  P. A. E. M. Janssen},
-  title =        {Refinements to a prognostic scheme of sea surface
-                  skin temperature},
-  journal =      JGR,
-  year =         2010,
-  Volume =       115,
-  Pages =        {C06009},
-  doi =          {10.1029/2009JC005985},
-}
-
-@ARTICLE{Talagrand_JAS72,
-  author =       {O. Talagrand},
-  title =        {On the damping of high-frequency motions in
-                  four-dimensional assimilation of meteorological
-                  data},
-  journal =      JAS,
-  year =         1972,
-  volume =       29,
-  pages =        {1571-1574}
-}
-
-@ARTICLE{Thiem_Berntsen_OM06,
-  author =       {O. Thiem and J. Berntsen},
-  title =        {Internal pressure errors in sigma-coordinate ocean
-                  models due to anisotropy},
-  journal =      OM,
-  year =         2006,
-  volume =       12,
-  number =       {1-2},
-}
-
-@ARTICLE{Timmermann_al_OM05,
-  author =       {R. Timmermann and H. Goosse and G. Madec and
-                  T. Fichefet and C. \'{E}the and V. Duli\`{e}re},
-  title =        {On the representation of high latitude processes in
-                  the ORCA-LIM global coupled sea ice-ocean model},
-  journal =      OM,
-  year =         2005,
-  volume =       8,
-  pages =        {175--201}
-}
-
-@ARTICLE{Tonani_al_OS08,
-  author =       {M. Tonani and N. Pinardi and S. Dobricic and
-                  I. Pujol and C. Fratianni},
-  title =        {A high-resolution free-surface model of the
-                  Mediterranean Sea},
-  journal =      OS,
-  year =         2008,
-  volume =       4,
-  pages =        {1--14}
-}
-
-@ARTICLE{Treguier_JGR92,
-  author =       {A.M. Tr\'{e}guier},
-  title =        {Kinetic energy analysis of an eddy resolving,
-                  primitive equation North Atlantic model},
-  journal =      JGR,
-  year =         1992,
-  volume =       97,
-  pages =        {687--701}
-}
-
-@ARTICLE{Treguier_al_JGR01,
-  author =       {A.M. Tr\'{e}guier and B. Barnier and A.P. de Miranda
-                  and J.M. Molines and N. Grima and M. Imbard and
-                  G. Madec and C. Messager and T. Reynaud and
-                  S. Michel},
-  title =        {An Eddy Permitting model of the Atlantic
-                  circulation: evaluating open boundary conditions},
-  journal =      JGR,
-  year =         2001,
-  volume =       106,
-  pages =        {22,115--22,129}
-}
-
-@ARTICLE{Treguier_al_DSR03,
-  author =       {A.-M. Tr\'{e}guier and O. Boedel and B. Barnier and
-                  G. Madec},
-  title =        {Agulhas eddy fluxes in a 1/6^o Atlantic model},
-  journal =      DSR,
-  year =         2003,
-  pages =        {251--280}
-}
-
-@ARTICLE{Treguier1996,
-  author =       {A.-M. Tr\'{e}guier and J. Dukowicz and K. Bryan},
-  title =        {Properties of nonuniform grids used in ocean general
-                  circulation models},
-  journal =      JGR,
-  year =         1996,
-  volume =       101,
-  pages =        {20,877--20,881}
-}
-
-@ARTICLE{Treguier_al_OS07,
-  author =       {A.-M. Tr\'{e}guier and M. H. England and
-                  S. R. Rintoul and G. Madec and J. Le Sommer and
-                  J.-M. Molines},
-  title =        {Southern Ocean overturning across streamlines in an
-                  eddying simulation of the Antarctic Circumpolar
-                  Current},
-  journal =      OS,
-  year =         2007,
-  volume =       4,
-  pages =        {653--698}
-}
-
-@ARTICLE{Treguier_al_OD06,
-  author =       {A.-M. Tr\'{e}guier and C. Gourcuff and P. Lherminier
-                  and H. Mercier and B. Barnier and G. Madec and
-                  J.-M. Molines and T. Penduff and L. Czeschel and
-                  C. Böning},
-  title =        {Internal and forced variability along a section
-                  between Greenland and Portugal in the CLIPPER
-                  Atlantic model},
-  journal =      OD,
-  year =         2006,
-  volume =       56,
-  pages =        {568--580},
-  doi =          {10.1007/s10236-006-0069-y},
-}
-
-@ARTICLE{Treguier1997,
-  author =       {A. M. Tr\'{e}guier and I. M. Held and
-                  V. D. Larichev},
-  title =        {Parameterization of Quasigeostrophic Eddies in
-                  Primitive Equation Ocean Models},
-  journal =      JPO,
-  year =         1997,
-  volume =       27,
-  number =       4,
-  pages =        {567--580}
-}
-
-@ARTICLE{Tu_Tsuang_GRL05,
-  title =        {{Cool-skin simulation by a one-column ocean model}},
-  author =       {{C-Y}. Tu and {B-J}. Tsuang},
-  journal =      GRL,
-  year =         2005,
-  volume =       32,
-  pages =        {L22602},
-  doi =          {10.1029/2005GL024252},
-}
-
-@ARTICLE{Umlauf_Burchard_JMS03,
-  author =       {L. Umlauf and H. Burchard},
-  title =        {A generic length-scale equation for geophysical
-                  turbulence models},
-  journal =      JMS,
-  year =         2003,
-  volume =       61,
-  number =       2,
-  pages =        {235--265}
-}
-
-@ARTICLE{Umlauf_Burchard_CSR05,
-  author =       {L. Umlauf and H. Burchard},
-  title =        {Second-order turbulence closure models for
-                  geophysical boundary layers. A review of recent
-                  work},
-  journal =      JMS,
-  year =         2005,
-  volume =       25,
-  pages =        {795--827}
-}
-
-@BOOK{UNESCO1983,
-  title =        {Algorithms for computation of fundamental property
-                  of sea water},
-  publisher =    {Techn. Paper in Mar. Sci, 44, UNESCO},
-  year =         1983,
-  author =       {UNESCO}
-}
-
-@TECHREPORT{OASIS2006,
-  author =       {S. Valcke},
-  title =        {OASIS3 User Guide (prism\_2-5)},
-  institution =  {PRISM Support Initiative Report No 3, CERFACS,
-                  Toulouse, France},
-  year =         2006,
-  pages =        {64pp}
-}
-
-@TECHREPORT{Valcke_al_Rep00,
-  author =       {S. Valcke and L. Terray and A. Piacentini },
-  title =        {The OASIS Coupled User Guide Version 2.4},
-  institution =  {CERFACS},
-  year =         2000,
-  number =       {TR/CMGC/00-10}
-}
-
-@ARTICLE{Vancoppenolle_al_OM09b,
-  author =       {M. Vancoppenolle and T. Fichefet and H. Goosse},
-  title =        {Simulating the mass balance and salinity of Arctic
-                  and Antarctic sea ice. 2.  Importance of sea ice
-                  salinity variations},
-  journal =      OM,
-  year =         2009,
-  volume =       27,
-  pages =        {54--69}
-}
-
-@book{Vallis06,
-  author =       {Vallis, G. K.},
-  title =        {Atmospheric and Oceanic Fluid Dynamics},
-  publisher =    {Cambridge University Press},
-  address =      {Cambridge, U.K.},
-  year =         2006,
-  pages =        745,
-}
-
-@ARTICLE{Vancoppenolle_al_OM09a,
-  author =       {M. Vancoppenolle and T. Fichefet and H. Goosse and
-                  S. Bouillon and G. Madec and M. A. Morales Maqueda},
-  title =        {Simulating the mass balance and salinity of Arctic
-                  and Antarctic sea ice. 1. Model description and
-                  validation},
-  journal =      OM,
-  year =         2009,
-  volume =       27,
-  pages =        {33--53},
-  doi =          {10.1016/j.ocemod.2008.10.005},
-}
-
-@ARTICLE{Vialard_al_JPO01,
-  author =       {J. Vialard and C. Menkes and J.-P. Boulanger and
-                  P. Delecluse and E. Guilyardi and M.J. McPhaden and
-                  G. Madec},
-  title =        {A Model Study of Oceanic Mechanisms Affecting
-                  Equatorial Pacific Sea Surface Temperature During
-                  the 1997-98 El Niño},
-  journal =      JPO,
-  year =         2001,
-  volume =       31,
-  number =       7,
-  pages =        {1649--1675}
-}
-
-@ARTICLE{Warner_al_OM05,
-  author =       {J. C. Warner and C. R. Sherwood and H. G. Arango and
-                  R. P. Signell},
-  title =        {Performance of four turbulence closure models
-                  implemented using a generic length scale method},
-  journal =      OM,
-  year =         2005,
-  volume =       8,
-  pages =        {81--113},
-  doi =          {10.1016/j.ocemod.2003.12.003},
-}
-
-@ARTICLE{WarnerEtal13,
-   author =      {John C. Warner and Zafer Defne and Kevin Haas and
-                  Hernan G. Arango},
-   title =       {A wetting and drying scheme for ROMS},
-   journal =     "Computers \& Geosciences",
-   volume =      "58", 
-   pages =       "54 - 61",
-   year =        "2013",
-   issn =        "0098-3004",
-   doi =         "https://doi.org/10.1016/j.cageo.2013.05.004",
-   url =         "http://www.sciencedirect.com/science/article/pii/S0098300413001362",
-}
-
-@ARTICLE{Weatherly_JMR84,
-  author =       {G. L. Weatherly},
-  title =        {An estimate of bottom frictional dissipation by Gulf
-                  Stream fluctuations},
-  journal =      JMR,
-  year =         1984,
-  volume =       42,
-  number =       2,
-  pages =        {289--301}
-}
-
-@ARTICLE{Weaver_Eby_JPO97,
-  author =       {A. J. Weaver and M. Eby},
-  title =        {On the numerical implementation of advection schemes
-                  for use in conjuction with various mixing
-                  parameterizations in the GFDL ocean model},
-  journal =      JPO,
-  year =         1997,
-  volume =       27
-}
-
-@ARTICLE{Webb_al_JAOT98,
-  author =       {D. J. Webb and B. A. de Cuevas and C. S. Richmond},
-  title =        {Improved Advection Schemes for Ocean Models},
-  journal =      JAOT,
-  year =         1998,
-  volume =       15,
-  number =       5,
-  pages =        {1171--1187},
-}
-
-@ARTICLE{White_al_JCP09,
-  author =       {L. White and A. Adcroft and R. Hallberg},
-  title =        {High-order regridding-remapping schemes for
-                  continuous isopycnal and generalized coordinates in
-                  ocean models},
-  journal =      JC,
-  year =         2009,
-  volume =       228,
-  pages =        {8665--8692}
-}
-
-@ARTICLE{Wilcox_1988,
-  author =       {D. C. Wilcox},
-  title =        {Reassessment of the scale-determining equation for
-                  advanced turbulence models},
-  journal =      {AIAA journal},
-  year =         1988,
-  volume =       26,
-  number =       11,
-  pages =        {1299--1310}
-}
-
-@ARTICLE{Willebrand_al_PO01,
-  author =       {J. Willebrand and B. Barnier and C. Boning and
-                  C. Dieterich and P.  D. Killworth and C. Le Provost
-                  and Y. Jia and J.-M. Molines and A. L. New},
-  title =        {Circulation characteristics in three eddy-permitting
-                  models of the North Atlantic},
-  journal =      PO,
-  year =         2001,
-  volume =       48,
-  number =       2,
-  pages =        {123--161}
-}
-
-@ARTICLE{Williams_al_DAO09,
-  author =       {P.D. Williams and E. Guilyardi and G. Madec and
-                  S. Gualdi and E. Scoccimarro},
-  title =        {The role of mean ocean salinity on climate},
-  journal =      DAO,
-  year =         2010,
-  volume =       49,
-  number =       {2-3},
-  pages =        {108--123},
-  doi =          {10.1016/j.dynatmoce.2009.02.001},
-}
-
-@ARTICLE{Williams_al_GRL07,
-  author =       {P.D. Williams and E. Guilyardi and R. Sutton and
-                  J.M. Gregory and G. Madec},
-  title =        {A new feedback on climate change from the
-                  hydrological cycle},
-  journal =      GRL,
-  year =         2007,
-  volume =       34,
-  pages =        {L08706},
-  doi =          {10.1029/2007GL029275},
-}
-
-@ARTICLE{Williams_al_CD06,
-  author =       {P.D. Williams and E. Guilyardi and R. Sutton and
-                  J.M. Gregory and G. Madec},
-  title =        {On the climate response of the low-latitude Pacific
-                  ocean to changes in the global freshwater cycle},
-  journal =      CD,
-  year =         2006,
-  volume =       27,
-  pages =        {593--611}
-}
-
-@ARTICLE{Zalesak_JCP79,
-  author =       {S. T. Zalesak},
-  title =        {Fully multidimensional flux corrected transport
-                  algorithms for fluids},
-  journal =      JCP,
-  year =         1979,
-  volume =       31
-}
-
-@ARTICLE{Zhang_Endoh_JGR92,
-  author =       {Zhang, R.-H. and Endoh, M.},
-  title =        {A free surface general circulation model for the
-                  tropical Pacific Ocean},
-  journal =      JGR,
-  year =         1992,
-  volume =       97,
-  pages =        {11,237--11,255}
-}
Index: NEMO/branches/2019/fix_vvl_ticket1791/doc/latex/NEMO/main/NEMO_manual.ist
===================================================================
--- NEMO/branches/2019/fix_vvl_ticket1791/doc/latex/NEMO/main/NEMO_manual.ist	(revision 10999)
+++ NEMO/branches/2019/fix_vvl_ticket1791/doc/latex/NEMO/main/NEMO_manual.ist	(revision 11422)
@@ -1,3 +1,1 @@
-delim_0 "\\dotfill"
-delim_1 "\\dotfill"
-delim_2 "\\dotfill"
+link ../../global/index.ist
Index: NEMO/branches/2019/fix_vvl_ticket1791/doc/latex/NEMO/main/NEMO_manual.sty
===================================================================
--- NEMO/branches/2019/fix_vvl_ticket1791/doc/latex/NEMO/main/NEMO_manual.sty	(revision 10999)
+++ 	(revision )
@@ -1,176 +1,0 @@
-%% ==============================================================================
-%% NEMO_manual.sty: all customizations (packages, styles, cmds)
-%% ==============================================================================
-
-
-%% LaTeX packages
-%% ==============================================================================
-
-\usepackage{natbib}           %% bib
-\usepackage{caption}          %% caption
-\usepackage{xcolor}           %% color
-\usepackage{times}            %% font
-\usepackage{hyperref}         %% hyper
-\usepackage{idxlayout}        %% index
-\usepackage{enumitem}         %% list
-\usepackage{minted}           %% listing
-\usepackage{amsmath}          %% maths
-\usepackage{fancyhdr}         %% page
-\usepackage{minitoc}          %% toc
-\usepackage{subfiles}         %% subdocs
-\usepackage[utf8]{inputenc}   %% input encoding
-\usepackage{draftwatermark}   %% watermark
-\usepackage{textcomp}         %% Companion fonts
-
-%% Extensions in bundle package
-
-\usepackage{amssymb, graphicx, makeidx, tabularx}
-
-
-%% Configuration
-
-\captionsetup{margin=10pt, font={small}, labelsep=colon, labelfont={bf}}
-\graphicspath{{../../../figures/}}
-\hypersetup{
-	pdftitle={NEMO ocean engine}, pdfauthor={Gurvan Madec, and NEMO System Team},
-	colorlinks
-}
-\idxlayout{font=footnotesize, columns=3}
-\renewcommand{\bibfont}{\footnotesize}
-\renewcommand{\bibsep}{3pt}
-
-
-%% Styles
-%% ==============================================================================
-
-\pagestyle{fancy}
-\bibliographystyle{../main/ametsoc}
-
-%% Additionnal fonts
-
-\DeclareMathAlphabet{\mathpzc}{OT1}{pzc}{m}{it}
-
-
-%% Page layout
-
-\fancyhf{}
-\fancyhead[LE,RO]{\bfseries\thepage}
-\fancyhead[LO]{\bfseries\hspace{-0em}\rightmark}
-\renewcommand{\sectionmark}[1]{\markright{\thesection.\ #1}}
-\fancyhead[RE]{\bfseries\leftmark}
-\renewcommand{\chaptermark}[1]{\markboth{#1}{}}
-\renewcommand{\headrulewidth}{0.5pt}
-\renewcommand{\footrulewidth}{0pt  }
-\addtolength{\headheight}{2.6pt}
-
-
-%% Catcodes
-
-\makeatletter
-\def\LigneVerticale{\vrule height 5cm depth 2cm\hspace{0.1cm}\relax}
-\def\LignesVerticales{\let\LV\LigneVerticale\LV\LV\LV\LV\LV\LV\LV\LV\LV\LV}
-\def\GrosCarreAvecUnChiffre#1{
-	\rlap{\vrule height 0.8cm width 1cm depth 0.2cm}
-	\rlap{\hbox to 1cm{\hss\mbox{\color{white} #1}\hss}}
- 	\vrule height 0pt width 1cm depth 0pt
-}
-\def\@makechapterhead#1{
-	\hbox{
-		\huge\LignesVerticales\hspace{-0.5cm}
-		\GrosCarreAvecUnChiffre{\thechapter}\hspace{0.2cm}
-		\hbox{#1}
-	}
-	\par\vskip
-1cm
-}
-\def\@makeschapterhead#1{
-	\hbox{
-		\huge\LignesVerticales
-		\hbox{#1}
-	}
-	\par\vskip
-2cm
-}
-\def\cleardoublepage{\clearpage\if@twoside \ifodd\c@page\else
-  \hbox{}
-  \vspace*{\fill}
-  \vspace{\fill}
-  \thispagestyle{empty}
-  \newpage
-  \if@twocolumn\hbox{}\newpage\fi\fi\fi}
-\def\@seccntformat#1{\protect\makebox[0pt][r]{\csname the#1\endcsname\quad}}
-\makeatother
-
-
-%% Global custom commands: \newcommand{<name>}[<args>][<first argument value>]{<code>}
-%% ==============================================================================
-
-%% NEMO and Fortran in small capitals
-\newcommand{\NEMO}{\textsc{nemo}}
-\newcommand{\fortran}{\textsc{Fortran}}
-\newcommand{\fninety}{\textsc{Fortran 90}}
-
-%% Common aliases
-\renewcommand{\deg}[1][]{\ensuremath{^{\circ}#1}}
-\newcommand{\zstar }{\ensuremath{z^\star}}
-\newcommand{\sstar }{\ensuremath{s^\star}}
-\newcommand{\ztilde}{\ensuremath{\tilde z}}
-\newcommand{\stilde}{\ensuremath{\tilde s}}
-\newcommand{\ie}{\ensuremath{i.e.}}
-\newcommand{\eg}{\ensuremath{e.g.}}
-
-%% Inline maths
-\newcommand{\fractext}[2]{\textstyle \frac{#1}{#2}}
-\newcommand{\rdt}{\Delta t}
-
-%% Text env. for Gurvan
-\newcommand{\gmcomment}[1]{}
-
-%% Index entries (italic font for files, preformat for code)
-\newcommand{\hf}[1]{\textit{#1.h90}            \index{h90 file!#1}}
-\newcommand{\ifile}[1]{\textit{#1.nc}          \index{Input NetCDF files!#1.nc}}
-\newcommand{\jp}[1]{\texttt{#1}                \index{Model parameters!#1}}
-\newcommand{\key}[1]{\texttt{\textbf{key\_#1}} \index{CPP keys!key\_#1}}
-\newcommand{\mdl}[1]{\textit{#1.F90}           \index{Modules!#1}}
-\newcommand{\ngn}[1]{\texttt{#1}               \index{Namelist Group Name!#1}}
-\newcommand{\np}[1]{\texttt{#1}                \index{Namelist variables!#1}}
-\newcommand{\rou}[1]{\texttt{#1}               \index{Routines!#1}}
-
-%% Maths
-\newcommand{\lt}{\left}
-\newcommand{\rt}{\right}
-\newcommand{\vect}[1]{\ensuremath{\mathbf{#1}}}
-\newcommand{\pd}[2][]{\ensuremath{\frac{\partial #1}{\partial #2}}}
-
-%% Shortened DOI in bibliography
-\newcommand{\doi}[1]{\href{http://dx.doi.org/#1}{doi:#1}}
-
-%% Namelists inclusion
-\newcommand{\nlst}[1]{\forfile{../../../namelists/#1}}
-
-
-%% Minted package: syntax highlighting configuration
-%% ==============================================================================
-
-%% Global highlighting style
-\setminted{style=emacs, fontsize=\scriptsize, breaklines, frame=leftline}
-\setminted[xml]{style=borland} %% Specific per language
-
-%% Oneliner
-\newmint[forline]{fortran}{}   % \forline|...|
-\newmint[xmlline]{xml}{}       % \xmlline|...|
-\newmint[cmd]{console}{}       % \cmd|...|
-
-%% Multi-lines
-\newminted[forlines]{fortran}{}   % \begin{forlines}
-\newminted[xmllines]{xml}{}       % \begin{xmllines}
-\newminted[cmds]{console}{}       % \begin{cmds}
-\newminted[clines]{c}{}           % \begin{clines}
-
-%% File
-\newmintedfile[forfile]{fortran}{}   % \forfile{../namelists/nam...}
-
-%% Inline
-\newmintinline[forcode]{fortran}{fontsize=auto, frame=lines}   % \forcode{...}
-\newmintinline[xmlcode]{xml}{    fontsize=auto, frame=lines}   % \xmlcode{...}
-\newmintinline[snippet]{console}{fontsize=auto, frame=lines}   % \snippet{...}
Index: NEMO/branches/2019/fix_vvl_ticket1791/doc/latex/NEMO/main/NEMO_manual.tex
===================================================================
--- NEMO/branches/2019/fix_vvl_ticket1791/doc/latex/NEMO/main/NEMO_manual.tex	(revision 10999)
+++ NEMO/branches/2019/fix_vvl_ticket1791/doc/latex/NEMO/main/NEMO_manual.tex	(revision 11422)
@@ -1,131 +1,1 @@
-%% ==============================================================================
-%% NEMO Reference Manual
-%% ==============================================================================
-
-
-%% Run ./PDF_creation.sh to generate the manual with latexmk
-
-
-%% Preamble
-%% ==============================================================================
-
-%% Document layout
-\documentclass{book}
-
-%% Custom style (.sty)
-\usepackage{../main/NEMO_manual}
-
-%% Include references and index for single subfile compilation
-\newcommand{\biblio}{\bibliography{../main/NEMO_manual}}
-\newcommand{\pindex}{\printindex}
-
-\makeindex
-
-%% End of common preamble between main and sub-files
-\begin{document}
-
-%% Override custom cmds for full manual compilation
-\renewcommand{\biblio}{}
-\renewcommand{\pindex}{}
-
-
-%% Frontmatter
-%% ==============================================================================
-
-%% Frontpage
-\title{
-  \includegraphics[height=0.05\textheight]{CMCC}\hfill
-  \includegraphics[height=0.05\textheight]{CNRS}\hfill
-  \includegraphics[height=0.05\textheight]{MOI} \hfill
-  \includegraphics[height=0.05\textheight]{UKMO}\hfill
-  \includegraphics[height=0.05\textheight]{NERC}       \\
-  \includegraphics[ width=0.8\textwidth  ]{NEMO_grey}  \\
-  {\Huge NEMO ocean engine}                            \\
-}
-\author{
-  \Large Gurvan Madec and NEMO System Team
-  \thanks{
-    Yevgeny Aksenov, Mirek Andrejczuk, Mike Bell, Romain Bourdalle-Badie, Cl\'{e}ment Bricaud,
-    J\'{e}r\^{o}me Chanut, Stefania Ciliberti, Emanuela Clementi, Andrew Coward, Damiano Delrosso,
-    Massimiliano Drudi, Christian Eth\'{e}, Simona Flavoni, Doroteaciro Iovino, Claire L\'{e}vy, Tomas Lovato,
-    Nicolas Martin, S\'{e}bastien Masson, Pierre Mathiot, Gelsomina Mattia, Francesca Mele, Silvia Mocavero,
-    Simon M\"{u}ller, George Nurser, Enda O'Dea, Julien Paul, Cl\'{e}ment Rousset, Dave Storkey,
-    Martin Vancoppenolle
-  }                                                        \\
-                                                           \\
-  \textit{Issue 27, Notes du P\^{o}le de mod\'{e}lisation} \\
-  \textit{Institut Pierre-Simon Laplace (IPSL)}            \\
-  \textit{ISSN 1288-1619}
-}
-\date{Version 4.0 -- January 2019}
-%\date{\today}
-
-\maketitle
-\frontmatter
-
-
-%% ToC i.e. Table of Contents
-\dominitoc
-\tableofcontents
-
-
-%% Mainmatter
-%% ==============================================================================
-
-\mainmatter
-
-%% Foreword
-\subfile{../subfiles/foreword}
-
-%% Introduction
-\subfile{../subfiles/introduction}
-
-%% Chapters
-\subfile{../subfiles/chap_model_basics}
-\subfile{../subfiles/chap_time_domain}   % Time discretisation (time stepping strategy)
-\subfile{../subfiles/chap_DOM}           % Space discretisation
-\subfile{../subfiles/chap_TRA}           % Tracer advection/diffusion equation
-\subfile{../subfiles/chap_DYN}           % Dynamics : momentum equation
-\subfile{../subfiles/chap_SBC}           % Surface Boundary Conditions
-\subfile{../subfiles/chap_LBC}           % Lateral Boundary Conditions
-\subfile{../subfiles/chap_LDF}           % Lateral diffusion
-\subfile{../subfiles/chap_ZDF}           % Vertical diffusion
-\subfile{../subfiles/chap_DIA}           % Outputs and Diagnostics
-\subfile{../subfiles/chap_OBS}           % Observation operator
-\subfile{../subfiles/chap_ASM}           % Assimilation increments
-\subfile{../subfiles/chap_STO}           % Stochastic param.
-\subfile{../subfiles/chap_misc}          % Miscellaneous topics
-\subfile{../subfiles/chap_CONFIG}        % Predefined configurations
-
-%% Appendix
-\appendix
-\subfile{../subfiles/annex_A}					% Generalised vertical coordinate
-\subfile{../subfiles/annex_B}					% Diffusive operator
-\subfile{../subfiles/annex_C}					% Discrete invariants of the eqs.
-\subfile{../subfiles/annex_iso}				% Isoneutral diffusion using triads
-\subfile{../subfiles/annex_D}					% Coding rules
-
-%% Not included
-%\subfile{../subfiles/chap_conservation}	%
-%\subfile{../subfiles/annex_E}				% Notes on some on going staff
-
-
-%% Backmatter
-%% ==============================================================================
-
-\backmatter
-
-%% Bibliography
-\cleardoublepage
-\phantomsection
-\addcontentsline{toc}{chapter}{Bibliography}
-\bibliography{../main/NEMO_manual}
-
-%% Index
-\cleardoublepage
-\phantomsection
-\addcontentsline{toc}{chapter}{Index}
-\printindex
-
-
-\end{document}
+link ../../global/document.tex
Index: NEMO/branches/2019/fix_vvl_ticket1791/doc/latex/NEMO/main/ametsoc.bst
===================================================================
--- NEMO/branches/2019/fix_vvl_ticket1791/doc/latex/NEMO/main/ametsoc.bst	(revision 10999)
+++ 	(revision )
@@ -1,1662 +1,0 @@
-%%
-%% This is file `ametsoc7.bst',
-%% generated with the docstrip utility.
-%%
-%% The original source files were:
-%%
-%% merlin.mbs  (with options: `ay,nat,nm-rev1,ed-rev,jnrlst,nmdash,nmd-3,dt-beg,yr-com,yrp-col,thtit-a,vol-2bf,vnum-sp,volp-com,pgsep-s,num-xser,numser,ser-vol,bkpg-x,pg-bk,pre-edn,agu-doi,doi,edparc,bkedcap,edby,edbyy,blk-tit,in-x,pp,ed,abr,ednx,ord,jabr,eprint,url,url-nt,em-it,nfss,')
-%% ----------------------------------------
-%% *** Bibliography style file for ALL AMS Journals...version 1.0  ***
-%% *** Brian Papa - American Meteorological Society ***
-%% 
-%% Copyright 1994-2004 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}[2004/02/09 4.13 (PWD, AO, DPC)]
- %   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
-    archive
-    author
-    booktitle
-    chapter
-    doi
-    edition
-    editor
-    eid
-    eprint
-    howpublished
-    department
-    institution
-    journal
-    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$
-          "\newblock " 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 {date.block}
-{
-  ":" *
-  add.blank
-}
-
-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$ "" }
-    { "\textit{" swap$ * "}" * }
-  if$
-}
-FUNCTION {bolden}
-{ duplicate$ empty$
-    { pop$ "" }
-    { "\textbf{" swap$ * "}" * }
-  if$
-}
-FUNCTION {tie.or.space.prefix}
-{ duplicate$ text.length$ #3 <
-    { "~" }
-    { " " }
-  if$
-  swap$
-}
-
-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}
-{ "ed." }
-
-FUNCTION {bbl.volume}
-{ "Vol." }
-
-FUNCTION {bbl.of}
-{ "of" }
-
-FUNCTION {bbl.number}
-{ "No." }
-
-FUNCTION {bbl.nr}
-{ "No." }
-
-FUNCTION {bbl.in}
-{ "in" }
-
-FUNCTION {bbl.pages}
-{ "pp." }
-
-FUNCTION {bbl.page}
-{ "p." }
-
-FUNCTION {bbl.chapter}
-{ "chap." }
-
-FUNCTION {bbl.techrep}
-{ "Tech. Rep." }
-
-FUNCTION {bbl.mthesis}
-{ "Master's thesis" }
-
-FUNCTION {bbl.phdthesis}
-{ "Ph.D. thesis" }
-
-FUNCTION {bbl.first}
-{ "1st" }
-
-FUNCTION {bbl.second}
-{ "2d" }
-
-FUNCTION {bbl.third}
-{ "3d" }
-
-FUNCTION {bbl.fourth}
-{ "4th" }
-
-FUNCTION {bbl.fifth}
-{ "5th" }
-
-FUNCTION {bbl.st}
-{ "st" }
-
-FUNCTION {bbl.nd}
-{ "d" }
-
-FUNCTION {bbl.rd}
-{ "d" }
-
-FUNCTION {bbl.th}
-{ "th" }
-
-MACRO {jan} {"Jan."}
-
-MACRO {feb} {"Feb."}
-
-MACRO {mar} {"Mar."}
-
-MACRO {apr} {"Apr."}
-
-MACRO {may} {"May"}
-
-MACRO {jun} {"Jun."}
-
-MACRO {jul} {"Jul."}
-
-MACRO {aug} {"Aug."}
-
-MACRO {sep} {"Sep."}
-
-MACRO {oct} {"Oct."}
-
-MACRO {nov} {"Nov."}
-
-MACRO {dec} {"Dec."}
-
-FUNCTION {eng.ord}
-{ duplicate$ "1" swap$ *
-  #-2 #1 substring$ "1" =
-     { bbl.th * }
-     { duplicate$ #-1 #1 substring$
-       duplicate$ "1" =
-         { pop$ bbl.st * }
-         { duplicate$ "2" =
-             { pop$ bbl.nd * }
-             { "3" =
-                 { bbl.rd * }
-                 { bbl.th * }
-               if$
-             }
-           if$
-          }
-       if$
-     }
-   if$
-}
-
-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. Software Eng."}
-
-MACRO {ieeetc} {"IEEE Trans. Comput."}
-
-MACRO {ieeetcad}
- {"IEEE Trans. Comput. Aid. Des."}
-
-MACRO {ipl} {"Inf. Process. Lett."}
-
-MACRO {jacm} {"J.~ACM"}
-
-MACRO {jcss} {"J.~Comput. Syst. Sci."}
-
-MACRO {scp} {"Sci. Comput. Program."}
-
-MACRO {sicomp} {"SIAM J. Comput."}
-
-MACRO {tocs} {"ACM Trans. Comput. Syst."}
-
-MACRO {tods} {"ACM Trans. Database Syst."}
-
-MACRO {tog} {"ACM Trans. Graphic."}
-
-MACRO {toms} {"ACM Trans. Math. Software"}
-
-MACRO {toois} {"ACM Trans. Office Inf. Syst."}
-
-MACRO {toplas} {"ACM Trans. Progr. Lang. Syst."}
-
-MACRO {tcs} {"Theor. Comput. Sci."}
-
-FUNCTION {bibinfo.check}
-{ swap$
-  duplicate$ missing$
-    {
-      pop$ pop$
-      ""
-    }
-    { duplicate$ empty$
-        {
-          swap$ pop$
-        }
-        { swap$
-          pop$
-        }
-      if$
-    }
-  if$
-}
-FUNCTION {bibinfo.warn}
-{ swap$
-  duplicate$ missing$
-    {
-      swap$ "missing " swap$ * " in " * cite$ * warning$ pop$
-      ""
-    }
-    { duplicate$ empty$
-        {
-          swap$ "empty " swap$ * " in " * cite$ * warning$
-        }
-        { swap$
-          pop$
-        }
-      if$
-    }
-  if$
-}
-FUNCTION {format.eprint}
-{ eprint duplicate$ empty$
-    'skip$
-    { "\eprint"
-      archive empty$
-        'skip$
-        { "[" * archive * "]" * }
-      if$
-      "{" * swap$ * "}" *
-    }
-  if$
-}
-STRINGS  { bibinfo}
-INTEGERS { nameptr namesleft numnames }
-
-FUNCTION {format.names}
-{ 'bibinfo :=
-  duplicate$ empty$ 'skip$ {
-  's :=
-  "" 't :=
-  #1 'nameptr :=
-  s num.names$ 'numnames :=
-  numnames 'namesleft :=
-    { namesleft #0 > }
-    { s nameptr
-      duplicate$ #1 >
-        { "{f.~}{vv~}{ll}{, jj}" }
-        { "{vv~}{ll}{, f.}{, jj}" }
-      if$
-      format.name$
-      bibinfo bibinfo.check
-      '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$
-  } if$
-}
-FUNCTION {format.names.ed}
-{
-  format.names
-}
-FUNCTION {format.key}
-{ empty$
-    { key field.or.null }
-    { "" }
-  if$
-}
-
-FUNCTION {format.authors}
-{ author "author" format.names
-}
-FUNCTION {get.bbl.editor}
-{ editor num.names$ #1 > 'bbl.editors 'bbl.editor if$ }
-
-FUNCTION {format.editors}
-{ editor "editor" format.names duplicate$ empty$ 'skip$
-    {
-      "," *
-      " " *
-      get.bbl.editor
-      capitalize
-   "(" swap$ * ")" *
-      *
-    }
-  if$
-}
-FUNCTION {format.book.pages}
-{ pages "pages" bibinfo.check
-  duplicate$ empty$ 'skip$
-    { " " * bbl.pages * }
-  if$
-}
-FUNCTION {format.doi}
-{ doi "doi" bibinfo.check
-  duplicate$ empty$ 'skip$
-    {
-      "\doi{" swap$ * "}" *
-    }
-  if$
-}
-FUNCTION {format.note}
-{
-  url empty$
-    'skip$
-    { "\urlprefix\url{" url * "}" * output }
-  if$
- note empty$
-    { "" }
-    { note #1 #1 substring$
-      duplicate$ "{" =
-        'skip$
-        { output.state mid.sentence =
-          { "l" }
-          { "u" }
-        if$
-        change.case$
-        }
-      if$
-      note #2 global.max$ substring$ * "note" bibinfo.check
-    }
-  if$
-}
-
-FUNCTION {format.title}
-{ title
-  duplicate$ empty$ 'skip$
-    { "t" change.case$ }
-  if$
-  "title" bibinfo.check
-}
-FUNCTION {format.full.names}
-{'s :=
- "" 't :=
-  #1 'nameptr :=
-  s num.names$ 'numnames :=
-  numnames 'namesleft :=
-    { namesleft #0 > }
-    { s nameptr
-      "{vv~}{ll}" format.name$
-      't :=
-      nameptr #1 >
-        {
-          namesleft #1 >
-            { ", " * t * }
-            {
-              s nameptr "{ll}" format.name$ duplicate$ "others" =
-                { 't := }
-                { pop$ }
-              if$
-              t "others" =
-                {
-                  " " * bbl.etal *
-                }
-                {
-                  numnames #2 >
-                    { "," * }
-                    'skip$
-                  if$
-                  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 {if.digit}
-{ duplicate$ "0" =
-  swap$ duplicate$ "1" =
-  swap$ duplicate$ "2" =
-  swap$ duplicate$ "3" =
-  swap$ duplicate$ "4" =
-  swap$ duplicate$ "5" =
-  swap$ duplicate$ "6" =
-  swap$ duplicate$ "7" =
-  swap$ duplicate$ "8" =
-  swap$ "9" = or or or or or or or or or
-}
-FUNCTION {n.separate}
-{ 't :=
-  ""
-  #0 'numnames :=
-  { t empty$ not }
-  { t #-1 #1 substring$ if.digit
-      { numnames #1 + 'numnames := }
-      { #0 'numnames := }
-    if$
-    t #-1 #1 substring$ swap$ *
-    t #-2 global.max$ substring$ 't :=
-    numnames #5 =
-      { duplicate$ #1 #2 substring$ swap$
-        #3 global.max$ substring$
-        "\," swap$ * *
-      }
-      'skip$
-    if$
-  }
-  while$
-}
-FUNCTION {n.dashify}
-{
-  n.separate
-  '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 "year" bibinfo.check duplicate$ empty$
-    {
-      "empty year in " cite$ * "; set to ????" * warning$
-       pop$ "????"
-    }
-    'skip$
-  if$
-  extra.label *
-  before.all 'output.state :=
-  ", " swap$ *
-}
-FUNCTION {format.btitle}
-{ title "title" bibinfo.check
-  duplicate$ empty$ 'skip$
-    {
-      emphasize
-    }
-  if$
-}
-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.prefix
-      "volume" bibinfo.check * *
-      series "series" bibinfo.check
-      duplicate$ empty$ 'pop$
-%%% NO ITALIC SERIES        { emphasize ", " * swap$ * }
-      {", " * swap$ * }
-      if$
-      "volume and number" number either.or.check
-    }
-  if$
-}
-FUNCTION {format.number.series}
-{ volume empty$
-    { number empty$
-        { series field.or.null }
-        { series empty$
-            { number "number" bibinfo.check }
-            { output.state mid.sentence =
-                { bbl.number }
-                { bbl.number capitalize }
-              if$
-              number tie.or.space.prefix "number" bibinfo.check * *
-              bbl.in space.word *
-              series "series" bibinfo.check *
-            }
-          if$
-        }
-      if$
-    }
-    { "" }
-  if$
-}
-FUNCTION {is.num}
-{ chr.to.int$
-  duplicate$ "0" chr.to.int$ < not
-  swap$ "9" chr.to.int$ > not and
-}
-
-FUNCTION {extract.num}
-{ duplicate$ 't :=
-  "" 's :=
-  { t empty$ not }
-  { t #1 #1 substring$
-    t #2 global.max$ substring$ 't :=
-    duplicate$ is.num
-      { s swap$ * 's := }
-      { pop$ "" 't := }
-    if$
-  }
-  while$
-  s empty$
-    'skip$
-    { pop$ s }
-  if$
-}
-
-FUNCTION {convert.edition}
-{ extract.num "l" change.case$ 's :=
-  s "first" = s "1" = or
-    { bbl.first 't := }
-    { s "second" = s "2" = or
-        { bbl.second 't := }
-        { s "third" = s "3" = or
-            { bbl.third 't := }
-            { s "fourth" = s "4" = or
-                { bbl.fourth 't := }
-                { s "fifth" = s "5" = or
-                    { bbl.fifth 't := }
-                    { s #1 #1 substring$ is.num
-                        { s eng.ord 't := }
-                        { edition 't := }
-                      if$
-                    }
-                  if$
-                }
-              if$
-            }
-          if$
-        }
-      if$
-    }
-  if$
-  t
-}
-
-FUNCTION {format.edition}
-{ edition duplicate$ empty$ 'skip$
-    {
-      convert.edition
-      output.state mid.sentence =
-        { "l" }
-        { "t" }
-      if$ change.case$
-      "edition" bibinfo.check
-      " " * bbl.edition *
-    }
-  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 duplicate$ empty$ 'skip$
-    { duplicate$ multi.page.check
-        {
-          n.dashify
-        }
-        {
-        }
-      if$
-      "pages" bibinfo.check
-    }
-  if$
-}
-FUNCTION {format.journal.pages}
-{ pages duplicate$ empty$ 'pop$
-    { swap$ duplicate$ empty$
-        { pop$ pop$ format.pages }
-        {
-          ", " *
-          swap$
-          n.dashify
-          "pages" bibinfo.check
-          *
-        }
-      if$
-    }
-  if$
-}
-FUNCTION {format.journal.eid}
-{ eid "eid" bibinfo.check
-  duplicate$ empty$ 'pop$
-    { swap$ duplicate$ empty$ 'skip$
-      {
-          ", " *
-      }
-      if$
-      swap$ *
-    }
-  if$
-}
-FUNCTION {format.vol.num.pages}
-{ volume field.or.null
-  duplicate$ empty$ 'skip$
-    {
-      "volume" bibinfo.check
-    }
-  if$
-  number "number" bibinfo.check duplicate$ empty$ 'skip$
-    {
-      swap$ duplicate$ empty$
-        { "there's a number but no volume in " cite$ * warning$ }
-        'skip$
-      if$
-      swap$
-      "~(" swap$ * ")" *
-    }
-  if$ *
-  bolden
-  eid empty$
-    { format.journal.pages }
-    { format.journal.eid }
-  if$
-}
-
-FUNCTION {format.chapter.pages}
-{ chapter empty$
-    'format.pages
-    { type empty$
-        { bbl.chapter }
-        { type "l" change.case$
-          "type" bibinfo.check
-        }
-      if$
-      chapter tie.or.space.prefix
-      "chapter" bibinfo.check
-      * *
-      pages empty$
-        'skip$
-        { ", " * format.pages * }
-      if$
-    }
-  if$
-}
-
-FUNCTION {format.booktitle}
-{
-  booktitle "booktitle" bibinfo.check
-  emphasize
-}
-FUNCTION {format.in.ed.booktitle}
-{ format.booktitle duplicate$ empty$ 'skip$
-    {
-      editor "editor" format.names.ed duplicate$ empty$ 'pop$
-        {
-          get.bbl.editor
-          swap$ "," *
-          " " * swap$ *
-          swap$
-          "," *
-          " " * swap$
-          * }
-      if$
-      word.in swap$ *
-    }
-  if$
-}
-FUNCTION {format.thesis.type}
-{ type duplicate$ empty$
-    'pop$
-    { swap$ pop$
-      "t" change.case$ "type" bibinfo.check
-    }
-  if$
-}
-FUNCTION {format.tr.number}
-{ number "number" bibinfo.check
-  type duplicate$ empty$
-    { pop$ bbl.techrep }
-    'skip$
-  if$
-  "type" bibinfo.check
-  swap$ duplicate$ empty$
-    { pop$ "t" change.case$ }
-    { tie.or.space.prefix * * }
-  if$
-}
-FUNCTION {format.article.crossref}
-{
-  word.in
-  " \cite{" * crossref * "}" *
-}
-FUNCTION {format.book.crossref}
-{ volume duplicate$ empty$
-    { "empty volume in " cite$ * "'s crossref of " * crossref * warning$
-      pop$ word.in
-    }
-    { bbl.volume
-      capitalize
-      swap$ tie.or.space.prefix "volume" bibinfo.check * * 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 "address" bibinfo.check *
-        }
-        { t *
-          address empty$
-            'skip$
-            { ", " * address "address" bibinfo.check * }
-          if$
-        }
-      if$
-    }
-  if$
-}
-FUNCTION {format.publisher.address}
-{ publisher "publisher" bibinfo.warn format.org.or.pub
-}
-
-FUNCTION {format.organization.address}
-{ organization "organization" bibinfo.check format.org.or.pub
-}
-
-STRINGS {oldname}
-
-FUNCTION {name.or.dash}
-{ 's :=
-   oldname empty$
-     { s 'oldname := s }
-     { s oldname =
-         { "---{}---{}---" }
-         { 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
-  date.block
-  format.title "title" output.check
-  new.sentence
-  crossref missing$
-    {
-      journal
-      "journal" bibinfo.check
-      emphasize
-      "journal" output.check
-      format.vol.num.pages output
-  format.doi output
-    }
-    { format.article.crossref output.nonnull
-      format.pages output
-    }
-  if$
-  format.note output
-  format.eprint output
-  fin.entry
-}
-FUNCTION {book}
-{ output.bibitem
-  author empty$
-    { format.editors "author and editor" output.check
-      editor format.key output
-      add.blank
-      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
-  date.block
-  format.btitle "title" output.check
-  crossref missing$
-    { format.bvolume output
-  new.sentence
-      format.edition output
-      format.number.series output
-      format.publisher.address output
-    }
-    {
-  new.sentence
-      format.book.crossref output.nonnull
-    }
-  if$
-  format.book.pages output
-  format.doi output
-  format.note output
-  format.eprint output
-  fin.entry
-}
-FUNCTION {booklet}
-{ output.bibitem
-  format.authors output
-  author format.key output
-  name.or.dash
-  format.date "year" output.check
-  date.block
-  format.title "title" output.check
-  new.sentence
-  howpublished "howpublished" bibinfo.check output
-  address "address" bibinfo.check output
-  format.book.pages output
-  format.doi output
-  format.note output
-  format.eprint output
-  fin.entry
-}
-
-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
-  date.block
-  format.btitle "title" output.check
-  crossref missing$
-    {
-      format.bvolume output
-      format.chapter.pages "chapter and pages" output.check
-  new.sentence
-      format.edition output
-      format.number.series output
-      format.publisher.address output
-    }
-    {
-      format.chapter.pages "chapter and pages" output.check
-  new.sentence
-      format.book.crossref output.nonnull
-    }
-  if$
-  format.doi output
-  format.note output
-  format.eprint output
-  fin.entry
-}
-
-FUNCTION {incollection}
-{ output.bibitem
-  format.authors "author" output.check
-  author format.key output
-  name.or.dash
-  format.date "year" output.check
-  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.edition output
-      format.chapter.pages output
-    }
-    { format.incoll.inproc.crossref output.nonnull
-      format.chapter.pages output
-    }
-  if$
-  format.doi output
-  format.note output
-  format.eprint output
-  fin.entry
-}
-FUNCTION {inproceedings}
-{ output.bibitem
-  format.authors "author" output.check
-  author format.key output
-  name.or.dash
-  format.date "year" output.check
-  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 "organization" bibinfo.check output
-          format.publisher.address output
-        }
-      if$
-      format.bvolume output
-      format.pages output
-      format.number.series output
-      howpublished "howpublished" bibinfo.check output
-    }
-    { format.incoll.inproc.crossref output.nonnull
-      format.pages output
-    }
-  if$
-  format.doi output
-  format.note output
-  format.eprint output
-  fin.entry
-}
-FUNCTION {conference} { inproceedings }
-FUNCTION {manual}
-{ output.bibitem
-  format.authors output
-  author format.key output
-  name.or.dash
-  format.date "year" output.check
-  date.block
-  format.btitle "title" output.check
-  new.sentence
-  organization "organization" bibinfo.check output
-  address "address" bibinfo.check output
-  format.edition output
-  format.doi output
-  format.note output
-  format.eprint output
-  fin.entry
-}
-
-FUNCTION {mastersthesis}
-{ output.bibitem
-  format.authors "author" output.check
-  author format.key output
-  name.or.dash
-  format.date "year" output.check
-  date.block
-  format.title
-  "title" output.check
-  new.sentence
-  bbl.mthesis format.thesis.type output.nonnull
-  department "department" bibinfo.warn output
-  school "school" bibinfo.warn output
-  address "address" bibinfo.check output
-  format.doi output
-  format.note output
-  format.eprint output
-  fin.entry
-}
-
-FUNCTION {misc}
-{ output.bibitem
-  format.authors output
-  author format.key output
-  name.or.dash
-  format.date "year" output.check
-  date.block
-  format.title output
-  new.sentence
-  howpublished "howpublished" bibinfo.check output
-  format.doi output
-  format.note output
-  format.eprint output
-  fin.entry
-}
-FUNCTION {phdthesis}
-{ output.bibitem
-  format.authors "author" output.check
-  author format.key output
-  name.or.dash
-  format.date "year" output.check
-  date.block
-  format.title
-  "title" output.check
-  new.sentence
-  bbl.phdthesis format.thesis.type output.nonnull
-  school "school" bibinfo.warn output
-  address "address" bibinfo.check output
-  format.doi output
-  format.note output
-  format.eprint output
-  fin.entry
-}
-
-FUNCTION {proceedings}
-{ output.bibitem
-  format.editors output
-  editor format.key output
-  name.or.dash
-  format.date "year" output.check
-  date.block
-  format.btitle "title" output.check
-  format.bvolume output
-  format.number.series output
-  publisher empty$
-    { format.organization.address output }
-    { organization "organization" bibinfo.check output
-      format.publisher.address output
-    }
-  if$
-  format.doi output
-  format.note output
-  format.eprint output
-  fin.entry
-}
-
-FUNCTION {techreport}
-{ output.bibitem
-  format.authors "author" output.check
-  author format.key output
-  name.or.dash
-  format.date "year" output.check
-  date.block
-  format.title
-  "title" output.check
-  new.sentence
-  format.tr.number output.nonnull
-  institution "institution" bibinfo.warn output
-  address "address" bibinfo.check output
-  format.doi output
-  format.note output
-  format.eprint output
-  fin.entry
-}
-
-FUNCTION {unpublished}
-{ output.bibitem
-  format.authors "author" output.check
-  author format.key output
-  name.or.dash
-  format.date "year" output.check
-  date.block
-  format.title "title" output.check
-  format.doi output
-  format.note "note" output.check
-  format.eprint output
-  fin.entry
-}
-
-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 :=
-  "" 't :=
-  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$ "????" }
-     { purify$ #-1 #4 substring$ }
-  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$
-    { "{\natexlab{" 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$
-  "\providecommand{\natexlab}[1]{#1}"
-  write$ newline$
-  "\providecommand{\url}[1]{\texttt{#1}}"
-  write$ newline$
-  "\providecommand{\urlprefix}{URL }"
-  write$ newline$
-  "\expandafter\ifx\csname urlstyle\endcsname\relax"
-  write$ newline$
-  "  \providecommand{\doi}[1]{doi:\discretionary{}{}{}#1}\else"
-  write$ newline$
-  "  \providecommand{\doi}{doi:\discretionary{}{}{}\begingroup \urlstyle{rm}\Url}\fi"
-  write$ newline$
-  "\providecommand{\eprint}[2][]{\url{#2}}"
-  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 `ametsoc7.bst'.
Index: NEMO/branches/2019/fix_vvl_ticket1791/doc/latex/NEMO/main/appendices.tex
===================================================================
--- NEMO/branches/2019/fix_vvl_ticket1791/doc/latex/NEMO/main/appendices.tex	(revision 11422)
+++ NEMO/branches/2019/fix_vvl_ticket1791/doc/latex/NEMO/main/appendices.tex	(revision 11422)
@@ -0,0 +1,13 @@
+
+\subfile{../subfiles/annex_A}             %% Generalised vertical coordinate
+\subfile{../subfiles/annex_B}             %% Diffusive operator
+\subfile{../subfiles/annex_C}             %% Discrete invariants of the eqs.
+\subfile{../subfiles/annex_iso}	          %% Isoneutral diffusion using triads
+\subfile{../subfiles/annex_DOMAINcfg}     %% Brief notes on DOMAINcfg
+
+%% Not included
+%\subfile{../subfiles/chap_model_basics_zstar}
+%\subfile{../subfiles/chap_DIU}
+%\subfile{../subfiles/chap_conservation}
+%\subfile{../subfiles/annex_E}				%% Notes on some on going staff
+
Index: NEMO/branches/2019/fix_vvl_ticket1791/doc/latex/NEMO/main/bibliography.bib
===================================================================
--- NEMO/branches/2019/fix_vvl_ticket1791/doc/latex/NEMO/main/bibliography.bib	(revision 11422)
+++ NEMO/branches/2019/fix_vvl_ticket1791/doc/latex/NEMO/main/bibliography.bib	(revision 11422)
@@ -0,0 +1,3106 @@
+
+@article{         adcroft.campin_OM04,
+  title         = "Rescaled height coordinates for accurate representation of
+                  free-surface flows in ocean circulation models",
+  pages         = "269--284",
+  journal       = "Ocean Modelling",
+  volume        = "7",
+  number        = "3-4",
+  author        = "A. Adcroft and J.-M. Campin",
+  year          = "2004",
+  month         = "jan",
+  publisher     = "Elsevier BV",
+  issn          = "1463-5003",
+  doi           = "10.1016/j.ocemod.2003.09.003"
+}
+
+@article{         arakawa.hsu_MWR90,
+  title         = "Energy Conserving and Potential-Enstrophy Dissipating
+                  Schemes for the Shallow Water Equations",
+  pages         = "1960--1969",
+  journal       = "Monthly Weather Review",
+  volume        = "118",
+  number        = "10",
+  author        = "A. Arakawa and Y.-J. G. Hsu",
+  year          = "1990",
+  month         = "oct",
+  publisher     = "American Meteorological Society",
+  issn          = "1520-0493",
+  doi           = "10.1175/1520-0493(1990)118<1960:ecaped>2.0.co;2"
+}
+
+@article{         arakawa.lamb_MWR81,
+  title         = "A Potential Enstrophy and Energy Conserving Scheme for the
+                  Shallow Water Equations",
+  pages         = "18--36",
+  journal       = "Monthly Weather Review",
+  volume        = "109",
+  number        = "1",
+  author        = "A. Arakawa and V. R. Lamb",
+  year          = "1981",
+  month         = "jan",
+  publisher     = "American Meteorological Society",
+  issn          = "1520-0493",
+  doi           = "10.1175/1520-0493(1981)109<0018:apeaec>2.0.co;2"
+}
+
+@article{         arakawa_JCP66,
+  title         = "Computational design for long-term numerical integration
+                  of the equations of fluid motion: Two-dimensional
+                  incompressible flow. Part {I}",
+  pages         = "119--143",
+  journal       = "Journal of Computational Physics",
+  volume        = "1",
+  number        = "1",
+  author        = "A. Arakawa",
+  year          = "1966",
+  month         = "Aug",
+  publisher     = "Elsevier BV",
+  issn          = "0021-9991",
+  doi           = "10.1016/0021-9991(66)90015-5"
+}
+
+@article{         arbic.garner.ea_DSR04,
+  title         = "The accuracy of surface elevations in forward global
+                  barotropic and baroclinic tide models",
+  pages         = "3069--3101",
+  journal       = "Deep Sea Research",
+  volume        = "51",
+  number        = "25-26",
+  author        = "B. K. Arbic and S. T. Garner and R. W. Hallberg and H. L.
+                  Simmons",
+  year          = "2004",
+  month         = "dec",
+  publisher     = "Elsevier BV",
+  issn          = "0967-0645",
+  doi           = "10.1016/j.dsr2.2004.09.014"
+}
+
+@article{         artale.iudicone.ea_JGR02,
+  title         = "Role of surface fluxes in Ocean General Circulation Models
+                  using satellite sea surface temperature: Validation of and
+                  sensitivity to the forcing frequency of the Mediterranean
+                  thermohaline circulation",
+  pages         = "2901--2924",
+  journal       = "Journal of Geophysical Research",
+  volume        = "107",
+  number        = "C8",
+  author        = "V. Artale and D. Iudicone and R. Santoleri and V. Rupolo
+                  and S. Marullo and F. {D'O}rtenzio",
+  year          = "2002",
+  publisher     = "American Geophysical Union (AGU)",
+  issn          = "0148-0227",
+  doi           = "10.1029/2000jc000452"
+}
+
+@article{         asselin_MWR72,
+  title         = "Frequency Filter for Time Integrations",
+  pages         = "487--490",
+  journal       = "Monthly Weather Review",
+  volume        = "100",
+  number        = "6",
+  author        = "R. Asselin",
+  year          = "1972",
+  month         = "jun",
+  publisher     = "American Meteorological Society",
+  issn          = "1520-0493",
+  doi           = "10.1175/1520-0493(1972)100<0487:fffti>2.3.co;2"
+}
+
+@article{         axell_JGR02,
+  title         = "Wind-driven internal waves and Langmuir circulations in a
+                  numerical ocean model of the southern Baltic Sea",
+  journal       = "Journal of Geophysical Research",
+  volume        = "107",
+  number        = "C11",
+  author        = "L. B. Axell",
+  year          = "2002",
+  publisher     = "American Geophysical Union (AGU)",
+  issn          = "0148-0227",
+  doi           = "10.1029/2001jc000922"
+}
+
+@article{         barnier.madec.ea_OD06,
+  title         = "Impact of partial steps and momentum advection schemes in
+                  a global ocean circulation model at eddy-permitting
+                  resolution",
+  pages         = "543--567",
+  journal       = "Ocean Dynamics",
+  volume        = "56",
+  number        = "5-6",
+  author        = "B. Barnier and G. Madec and T. Penduff and J.-M. Molines
+                  and A.-M. Tr\'{e}guier and J. {Le Sommer} and A. Beckmann
+                  and A. Biastoch and C. B{\"{o}}ning and J. Dengg and C.
+                  Derval and E. Durand and S. Gulev and E. Remy and C.
+                  Talandier and S. Theetten and M. Maltrud and J. McClean and
+                  B. {de Cuevas}",
+  year          = "2006",
+  month         = "jun",
+  publisher     = "Springer Nature",
+  issn          = "1616-7228",
+  doi           = "10.1007/s10236-006-0082-1"
+}
+
+@article{         beckmann.doscher_JPO97,
+  title         = "A method for improved representation of dense water
+                  spreading over topography in geopotential-coordinate
+                  models",
+  pages         = "581--591",
+  journal       = "Journal of Physical Oceanography",
+  volume        = "27",
+  number        = "4",
+  author        = "A. Beckmann and R. D{\"{o}}scher",
+  year          = "1997",
+  month         = "apr",
+  publisher     = "American Meteorological Society",
+  issn          = "1520-0485",
+  doi           = "10.1175/1520-0485(1997)027<0581:amfiro>2.0.co;2"
+}
+
+@article{         beckmann.goosse_OM03,
+  title         = "A parameterization of ice shelf-ocean interaction for
+                  climate models",
+  pages         = "157--170",
+  journal       = "Ocean Modelling",
+  volume        = "5",
+  number        = "2",
+  author        = "A. Beckmann and H. Goosse",
+  year          = "2003",
+  month         = "jan",
+  publisher     = "Elsevier BV",
+  issn          = "1463-5003",
+  doi           = "10.1016/s1463-5003(02)00019-7"
+}
+
+@article{         beckmann.haidvogel_JPO93,
+  title         = "Numerical Simulation of Flow around a Tall Isolated
+                  Seamount. Part {I}: Problem Formulation and Model Accuracy",
+  pages         = "1736--1753",
+  journal       = "Journal of Physical Oceanography",
+  volume        = "23",
+  number        = "8",
+  author        = "A. Beckmann and D. B. Haidvogel",
+  year          = "1993",
+  month         = "aug",
+  publisher     = "American Meteorological Society",
+  issn          = "1520-0485",
+  doi           = "10.1175/1520-0485(1993)023<1736:nsofaa>2.0.co;2"
+}
+
+@article{ beljaars_QJRMS95,
+title = "The parametrization of surface fluxes in large-scale models under free convection",
+pages = "255--270",
+journal = "Quarterly Journal of the Royal Meteorological Society",
+volume = "121",
+number = "522",
+author = "Beljaars, Anton C. M.",
+year = "1995",
+month = "jan",
+ publisher     = "Wiley",
+issn = "00359009",
+doi = "10.1002/qj.49712152203"
+}
+
+@article{         bernie.guilyardi.ea_CD07,
+  title         = "Impact of resolving the diurnal cycle in an
+                  ocean-atmosphere {GCM}. Part 1: a diurnally forced {OGCM}",
+  pages         = "575--590",
+  journal       = "Climate Dynamics",
+  volume        = "29",
+  number        = "6",
+  author        = "D. J. Bernie and E. Guilyardi and G. Madec and J. M.
+                  Slingo and S. J. Woolnough",
+  year          = "2007",
+  month         = "may",
+  publisher     = "Springer Nature",
+  issn          = "1432-0894",
+  doi           = "10.1007/s00382-007-0249-6"
+}
+
+@article{         bernie.woolnough.ea_JC05,
+  title         = "Modeling diurnal and intraseasonal variability of the
+                  ocean mixed layer",
+  pages         = "1190--1202",
+  journal       = "Journal of Climate",
+  volume        = "18",
+  number        = "8",
+  author        = "D. J. Bernie and S. J. Woolnough and J. M. Slingo and E.
+                  Guilyardi",
+  year          = "2005",
+  month         = "apr",
+  publisher     = "American Meteorological Society",
+  issn          = "1520-0442",
+  doi           = "10.1175/jcli3319.1"
+}
+
+@article{         blanke.delecluse_JPO93,
+  title         = "Variability of the tropical Atlantic Ocean simulated by a
+                  General Circulation Model with two different mixed-layer
+                  physics",
+  pages         = "1363--1388",
+  journal       = "Journal of Physical Oceanography",
+  volume        = "23",
+  number        = "7",
+  author        = "B. Blanke and P. Del\'{e}cluse",
+  year          = "1993",
+  month         = "jul",
+  publisher     = "American Meteorological Society",
+  issn          = "1520-0485",
+  doi           = "10.1175/1520-0485(1993)023<1363:vottao>2.0.co;2"
+}
+
+@article{         blanke.raynaud_JPO97,
+  title         = "Kinematics of the Pacific Equatorial Undercurrent: An
+                  Eulerian and Lagrangian Approach from {GCM} Results",
+  pages         = "1038--1053",
+  journal       = "Journal of Physical Oceanography",
+  volume        = "27",
+  number        = "6",
+  author        = "B. Blanke and S. Raynaud",
+  year          = "1997",
+  month         = "jun",
+  publisher     = "American Meteorological Society",
+  issn          = "1520-0485",
+  doi           = "10.1175/1520-0485(1997)027<1038:kotpeu>2.0.co;2"
+}
+
+@article{         bloom.takacs.ea_MWR96,
+  title         = "Data assimilation using incremental analysis updates",
+  pages         = "1256--1271",
+  journal       = "Monthly Weather Review",
+  volume        = "124",
+  number        = "6",
+  author        = "S. C. Bloom and L. L. Takacs and A. M. Da Silva and D.
+                  Ledvina",
+  year          = "1996",
+  month         = "jun",
+  publisher     = "American Meteorological Society",
+  issn          = "1520-0493",
+  doi           = "10.1175/1520-0493(1996)124<1256:dauiau>2.0.co;2"
+}
+
+@article{         bouffard.boegman_DAO13,
+  title         = "A diapycnal diffusivity model for stratified environmental
+                  flows",
+  pages         = "14--34",
+  journal       = "Dynamics of Atmospheres and Oceans",
+  volume        = "61-62",
+  author        = "D. Bouffard and L. Boegman",
+  year          = "2013",
+  month         = "jun",
+  publisher     = "Elsevier BV",
+  issn          = "0377-0265",
+  doi           = "10.1016/j.dynatmoce.2013.02.002"
+}
+
+@article{         bougeault.lacarrere_MWR89,
+  title         = "Parameterization of Orography-Induced Turbulence in a
+                  Mesobeta--Scale Model",
+  pages         = "1872--1890",
+  journal       = "Monthly Weather Review",
+  volume        = "117",
+  number        = "8",
+  author        = "P. Bougeault and P. Lacarrere",
+  year          = "1989",
+  month         = "aug",
+  publisher     = "American Meteorological Society",
+  issn          = "1520-0493",
+  doi           = "10.1175/1520-0493(1989)117<1872:pooiti>2.0.co;2"
+}
+
+@article{         bouillon.maqueda.ea_OM09,
+  title         = "An elastic-viscous-plastic sea ice model formulated on
+                  Arakawa {B} and {C} grids",
+  pages         = "174--184",
+  journal       = "Ocean Modelling",
+  volume        = "27",
+  number        = "3-4",
+  author        = "S. Bouillon and M. A. Morales Maqueda and V. Legat and T.
+                  Fichefet",
+  year          = "2009",
+  month         = "jan",
+  publisher     = "Elsevier BV",
+  issn          = "1463-5003",
+  doi           = "10.1016/j.ocemod.2009.01.004"
+}
+
+@article{         brankart.candille.ea_GMD15,
+  title         = "A generic approach to explicit simulation of uncertainty
+                  in the {NEMO} ocean model",
+  pages         = "1285--1297",
+  journal       = "Geoscientific Model Development",
+  volume        = "8",
+  number        = "5",
+  author        = "J.-M. Brankart and G. Candille and F. Garnier and C.
+                  Calone and A. Melet and P.-A. Bouttier and P. Brasseur and
+                  J. Verron",
+  year          = "2015",
+  month         = "may",
+  publisher     = "Copernicus GmbH",
+  issn          = "1991-9603",
+  doi           = "10.5194/gmd-8-1285-2015"
+}
+
+@article{         brankart_OM13,
+  title         = "Impact of uncertainties in the horizontal density gradient
+                  upon low resolution global ocean modelling",
+  pages         = "64--76",
+  journal       = "Ocean Modelling",
+  volume        = "66",
+  author        = "J.-M. Brankart",
+  year          = "2013",
+  month         = "jun",
+  publisher     = "Elsevier BV",
+  issn          = "1463-5003",
+  doi           = "10.1016/j.ocemod.2013.02.004"
+}
+
+@article{         breivik.bidlot.ea_OM16,
+  title         = "A Stokes drift approximation based on the Phillips
+                  spectrum",
+  pages         = "49--56",
+  journal       = "Ocean Modelling",
+  volume        = "100",
+  author        = "{\O}. Breivik and J.-R. Bidlot and P. A. E. M. Janssen",
+  year          = "2016",
+  month         = "apr",
+  publisher     = "Elsevier BV",
+  issn          = "1463-5003",
+  doi           = "10.1016/j.ocemod.2016.01.005"
+}
+
+@article{         breivik.janssen.ea_JPO14,
+  title         = "Approximate Stokes Drift Profiles in Deep Water",
+  pages         = "2433--2445",
+  journal       = "Journal of Physical Oceanography",
+  volume        = "44",
+  number        = "9",
+  author        = "{\O}. Breivik and P. A. E. M. Janssen and J.-R. Bidlot",
+  year          = "2014",
+  month         = "sep",
+  publisher     = "American Meteorological Society",
+  issn          = "1520-0485",
+  doi           = "10.1175/jpo-d-14-0020.1"
+}
+
+@article{         brodeau.barnier.ea_OM10,
+  title         = "An {ERA40}-based atmospheric forcing for global ocean
+                  circulation models",
+  pages         = "88--104",
+  journal       = "Ocean Modelling",
+  volume        = "31",
+  number        = "3-4",
+  author        = "L. Brodeau and B. Barnier and A.-M. Tr\'{e}guier and T.
+                  Penduff and S. Gulev",
+  year          = "2010",
+  month         = "jan",
+  publisher     = "Elsevier BV",
+  issn          = "1463-5003",
+  doi           = "10.1016/j.ocemod.2009.10.005"
+}
+
+@article{         brodeau.barnier.ea_JPO16,
+  title         = "Climatologically Significant Effects of Some Approximations in the Bulk Parameterizations of Turbulent Air–Sea Fluxes",
+  pages         = "5--28",
+  journal       = "Journal of Physical Oceanography",
+  volume        = "47",
+  number        = "1",
+  author        = "Brodeau, Laurent and Barnier, Bernard and Gulev, Sergey K. and Woods, Cian",
+  year          = "2016",
+  month         = "jan",
+  publisher     = "American Meteorological Society",
+  issn          = "0022-3670",
+  doi           = "10.1175/jpo-d-16-0169.1",
+}
+
+@article{         brown.campana_MWR78,
+  title         = "An economical time-differencing system for numerical
+                  weather prediction",
+  pages         = "1125--1136",
+  journal       = "Monthly Weather Review",
+  volume        = "106",
+  number        = "8",
+  author        = "J. A. Brown and K. A. Campana",
+  year          = "1978",
+  month         = "aug",
+  publisher     = "American Meteorological Society",
+  issn          = "1520-0493",
+  doi           = "10.1175/1520-0493(1978)106<1125:aetsfn>2.0.co;2"
+}
+
+@article{         bryan_JCP97,
+  title         = "A numerical method for the study of the circulation of the
+                  world ocean",
+  pages         = "154--169",
+  journal       = "Journal of Computational Physics",
+  volume        = "135",
+  number        = "2",
+  author        = "K. Bryan",
+  year          = "1997",
+  month         = "Aug",
+  publisher     = "Elsevier BV",
+  issn          = "0021-9991",
+  doi           = "10.1006/jcph.1997.5699"
+}
+
+@article{         burchard_OM02,
+  title         = "Energy-conserving discretisation of turbulent shear and
+                  buoyancy production",
+  pages         = "347--361",
+  journal       = "Ocean Modelling",
+  volume        = "4",
+  number        = "3-4",
+  author        = "H. Burchard",
+  year          = "2002",
+  month         = "jun",
+  publisher     = "Elsevier BV",
+  issn          = "1463-5003",
+  doi           = "10.1016/s1463-5003(02)00009-4"
+}
+
+@article{         campin.adcroft.ea_OM04,
+  title         = "Conservation of properties in a free-surface model",
+  pages         = "221--244",
+  journal       = "Ocean Modelling",
+  volume        = "6",
+  number        = "3-4",
+  author        = "J.-M. Campin and A. Adcroft and C. Hill and J. Marshall",
+  year          = "2004",
+  month         = "jan",
+  publisher     = "Elsevier BV",
+  issn          = "1463-5003",
+  doi           = "10.1016/s1463-5003(03)00009-x"
+}
+
+@article{         campin.goosse_T99,
+  title         = "Parameterization of density-driven downsloping flow for a
+                  coarse-resolution ocean model in z-coordinate",
+  pages         = "412--430",
+  journal       = "Tellus A",
+  volume        = "51",
+  number        = "3",
+  author        = "J.-M. Campin and H. Goosse",
+  year          = "1999",
+  month         = "may",
+  publisher     = "Informa UK Limited",
+  issn          = "1600-0870",
+  doi           = "10.1034/j.1600-0870.1999.t01-3-00006.x"
+}
+
+@article{         campin.marshall.ea_OM08,
+  title         = "Sea ice-ocean coupling using a rescaled vertical
+                  coordinate \zstar",
+  pages         = "1--14",
+  journal       = "Ocean Modelling",
+  volume        = "24",
+  number        = "1-2",
+  author        = "J.-M. Campin and J. Marshall and D. Ferreira",
+  year          = "2008",
+  month         = "jan",
+  publisher     = "Elsevier BV",
+  issn          = "1463-5003",
+  doi           = "10.1016/j.ocemod.2008.05.005"
+}
+
+@article{         canuto.howard.ea_JPO01,
+  title         = "Ocean turbulence. Part {I}: One-point closure
+                  model-momentum and heat vertical diffusivities",
+  pages         = "1413--1426",
+  journal       = "Journal of Physical Oceanography",
+  volume        = "31",
+  number        = "6",
+  author        = "V. M. Canuto and A. Howard and Y. Cheng and M. S.
+                  Dubovikov",
+  year          = "2001",
+  month         = "jun",
+  publisher     = "American Meteorological Society",
+  issn          = "1520-0485",
+  doi           = "10.1175/1520-0485(2001)031<1413:otpiop>2.0.co;2"
+}
+
+@article{         carrere.lyard_GRL03,
+  title         = "Modeling the barotropic response of the global ocean to
+                  atmospheric wind and pressure forcing - comparisons with
+                  observations",
+  journal       = "Geophysical Research Letters",
+  volume        = "30",
+  number        = "6",
+  author        = "L. Carr\`{e}re and F. Lyard",
+  year          = "2003",
+  month         = "mar",
+  publisher     = "American Geophysical Union (AGU)",
+  issn          = "0094-8276",
+  doi           = "10.1029/2002gl016473"
+}
+
+@techreport{      chanut_rpt05,
+  title         = "Nesting code for {NEMO}",
+  pages         = "25",
+  author        = "J. Chanut",
+  institution   = "European Union: Marine Environment and Security for the
+                  European Area (MERSEA) Integrated Project",
+  year          = "2005",
+  month         = "may",
+  doi           = "10.5281/zenodo.3243409"
+}
+
+@article{         chassignet.smith.ea_JPO03,
+  title         = "North Atlantic Simulations with the Hybrid Coordinate
+                  Ocean Model ({HYCOM}): Impact of the Vertical Coordinate
+                  Choice, Reference Pressure, and Thermobaricity",
+  pages         = "2504--2526",
+  journal       = "Journal of Physical Oceanography",
+  volume        = "33",
+  number        = "12",
+  author        = "E. P. Chassignet and L. T. Smith and G. R. Halliwell and
+                  R. Bleck",
+  year          = "2003",
+  month         = "dec",
+  publisher     = "American Meteorological Society",
+  issn          = "1520-0485",
+  doi           = "10.1175/1520-0485(2003)033<2504:naswth>2.0.co;2"
+}
+
+@article{         cox_OM87,
+  title         = "Isopycnal diffusion in a z-coordinate ocean model",
+  pages         = "1--9",
+  journal       = "Ocean Modelling",
+  volume        = "74",
+  author        = "M. D. Cox",
+  year          = "1987",
+  month         = "jan",
+  url           = "https://www.researchgate.net/publication/243768762_Isopycnal_diffusion_in_a_z-coordinate_ocean_model"
+}
+
+@article{         craig.banner_JPO94,
+  title         = "Modeling wave-enhanced turbulence in the ocean surface
+                  layer",
+  pages         = "2546--2559",
+  journal       = "Journal of Physical Oceanography",
+  volume        = "24",
+  number        = "12",
+  author        = "P. D. Craig and M. L. Banner",
+  year          = "1994",
+  month         = "dec",
+  publisher     = "American Meteorological Society",
+  issn          = "1520-0485",
+  doi           = "10.1175/1520-0485(1994)024<2546:mwetit>2.0.co;2"
+}
+
+@article{         craik.leibovich_JFM76,
+  title         = "A rational model for Langmuir circulations",
+  pages         = "401--426",
+  journal       = "Journal of Fluid Mechanics",
+  volume        = "73",
+  number        = "3",
+  author        = "A. D. D. Craik and S. Leibovich",
+  year          = "1976",
+  month         = "feb",
+  publisher     = "Cambridge University Press (CUP)",
+  issn          = "1469-7645",
+  doi           = "10.1017/s0022112076001420"
+}
+
+@article{         dalessio.abdella.ea_JPO98,
+  title         = "A new second-order turbulence closure scheme for modeling
+                  the oceanic mixed layer",
+  pages         = "1624--1641",
+  journal       = "Journal of Physical Oceanography",
+  volume        = "28",
+  number        = "8",
+  author        = "S. J. D. D'Alessio and K. Abdella and N. A. McFarlane",
+  year          = "1998",
+  month         = "aug",
+  publisher     = "American Meteorological Society",
+  issn          = "1520-0485",
+  doi           = "10.1175/1520-0485(1998)028<1624:ansotc>2.0.co;2"
+}
+
+@book{            daley.barker_bk01,
+  pages         = "163",
+  booktitle     = "{NAVDAS} Source Book 2001: {NRL} Atmospheric Variational
+                  Data Assimilation System",
+  editor        = "Naval Research Laboratory, Marine Meteorology Division",
+  author        = "R. Daley and E. Barker",
+  year          = "2001",
+  month         = "jul",
+  publisher     = "Defense Technical Information Center",
+  doi           = "10.21236/ada396883"
+}
+
+@article{         danabasoglu.ferrari.ea_JC08,
+  title         = "Sensitivity of an Ocean General Circulation Model to a
+                  parameterization of near-surface eddy fluxes",
+  pages         = "1192--1208",
+  journal       = "Journal of Climate",
+  volume        = "21",
+  number        = "6",
+  author        = "G. Danabasoglu and R. Ferrari and J. C. McWilliams",
+  year          = "2008",
+  month         = "mar",
+  publisher     = "American Meteorological Society",
+  issn          = "1520-0442",
+  doi           = "10.1175/2007jcli1508.1"
+}
+
+@article{         davies_QJRMS76,
+  title         = "A lateral boundary formulation for multi-level prediction
+                  models",
+  pages         = "405--418",
+  journal       = "Quarterly Journal of the Royal Meteorological Society",
+  volume        = "102",
+  number        = "432",
+  author        = "H. C. Davies",
+  year          = "1976",
+  month         = "apr",
+  publisher     = "Wiley",
+  issn          = "0035-9009",
+  doi           = "10.1002/qj.49710243210"
+}
+
+@article{         de-boyer-montegut.madec.ea_JGR04,
+  title         = "Mixed layer depth over the global ocean: An examination of
+                  profile data and a profile-based climatology",
+  pages         = "C12003",
+  journal       = "Journal of Geophysical Research",
+  volume        = "109",
+  number        = "C12",
+  author        = "C. {de Boyer Mont\'{e}gut} and G. Madec and A. S. Fischer
+                  and A. Lazar and D. Iudicone",
+  year          = "2004",
+  publisher     = "American Geophysical Union (AGU)",
+  issn          = "0148-0227",
+  doi           = "10.1029/2004jc002378"
+}
+
+@article{         de-lavergne.madec.ea_JPO16,
+  title         = "The impact of a variable mixing efficiency on the abyssal
+                  overturning",
+  pages         = "663--681",
+  journal       = "Journal of Physical Oceanography",
+  volume        = "46",
+  number        = "2",
+  author        = "C. {de Lavergne} and G. Madec and J. {Le Sommer} and A. J.
+                  G. Nurser and A. C. Naveira Garabato",
+  year          = "2016",
+  month         = "feb",
+  publisher     = "American Meteorological Society",
+  issn          = "1520-0485",
+  doi           = "10.1175/jpo-d-14-0259.1"
+}
+
+@article{         debreu.vouland.ea_CG08,
+  title         = "{AGRIF}: Adaptive Grid Refinement In Fortran",
+  pages         = "8--13",
+  journal       = "Computers \& Geosciences",
+  volume        = "34",
+  number        = "1",
+  author        = "L. Debreu and C. Vouland and E. Blayo",
+  year          = "2008",
+  month         = "jan",
+  publisher     = "Elsevier BV",
+  issn          = "0098-3004",
+  doi           = "10.1016/j.cageo.2007.01.009"
+}
+
+@incollection{    delecluse.madec_icol99,
+  title         = "Ocean modelling and the role of the ocean in the climate
+                  system",
+  pages         = "237--313",
+  booktitle     = "Modeling the Earth's Climate and its Variability",
+  editor        = "W. R. Holland and S. Joussaume and F. David",
+  series        = "Les Houches",
+  volume        = "67",
+  author        = "P. Del\'{e}cluse and G. Madec",
+  year          = "1999",
+  publisher     = "North Holland",
+  isbn          = "978-0-444-50338-1"
+}
+
+@phdthesis{       demange_phd14,
+  title         = "Advection and gravity waves propagation numerical schemes
+                  for oceanic circulation models",
+  pages         = "138",
+  author        = "J. Demange",
+  school        = "Grenoble University, France",
+  year          = "2014",
+  url           = "https://tel.archives-ouvertes.fr/tel-01104703/file/DEMANGE_2014_archivage.pdf"
+}
+
+@article{         dobricic.pinardi.ea_OS07,
+  title         = "Daily oceanographic analyses by Mediterranean Forecasting
+                  System at the basin scale",
+  pages         = "149--157",
+  journal       = "Ocean Science",
+  volume        = "3",
+  number        = "1",
+  author        = "S. Dobricic and N. Pinardi and M. Adani and M. Tonani and
+                  C. Fratianni and A. Bonazzi and V. Fernandez",
+  year          = "2007",
+  month         = "mar",
+  publisher     = "Copernicus GmbH",
+  issn          = "1812-0792",
+  doi           = "10.5194/os-3-149-2007"
+}
+
+@article{         drijfhout_JPO94,
+  title         = "Heat transport by mesoscale eddies in an ocean circulation
+                  Model",
+  pages         = "353--369",
+  journal       = "Journal of Physical Oceanography",
+  volume        = "24",
+  number        = "2",
+  author        = "S. S. Drijfhout",
+  year          = "1994",
+  month         = "feb",
+  publisher     = "American Meteorological Society",
+  issn          = "1520-0485",
+  doi           = "10.1175/1520-0485(1994)024<0353:htbmei>2.0.co;2"
+}
+
+@article{         dukowicz.smith_JGR94,
+  title         = "Implicit free-surface method for the Bryan-Cox-Semtner
+                  ocean model",
+  pages         = "7991--8014",
+  journal       = "Journal of Geophysical Research",
+  volume        = "99",
+  number        = "C4",
+  author        = "J. K. Dukowicz and R. D. Smith",
+  year          = "1994",
+  publisher     = "American Geophysical Union (AGU)",
+  issn          = "0148-0227",
+  doi           = "10.1029/93jc03455"
+}
+
+@article{ edson.jampana.ea_JPO13,
+title = "On the Exchange of Momentum over the Open Ocean",
+pages = "1589--1610",
+journal = "Journal of Physical Oceanography",
+volume = "43",
+number = "8",
+author = "Edson, James B. and Jampana, Venkata and Weller, Robert A. and Bigorre, Sebastien P. and Plueddemann, Albert J. and Fairall, Christopher W. and Miller, Scott D. and Mahrt, Larry and Vickers, Dean and Hersbach, Hans",
+year = "2013",
+month = "aug",
+publisher = "American Meteorological Society",
+issn = "0022-3670",
+doi = "10.1175/JPO-D-12-0173.1"
+}
+
+@article{         egbert.ray_JGR01,
+  title         = "Estimates of {M2} tidal energy dissipation from
+                  {TOPEX}/Poseidon altimeter data",
+  pages         = "22475--22502",
+  journal       = "Journal of Geophysical Research",
+  volume        = "106",
+  number        = "C10",
+  author        = "G. D. Egbert and R. D. Ray",
+  year          = "2001",
+  month         = "oct",
+  publisher     = "American Geophysical Union (AGU)",
+  issn          = "0148-0227",
+  doi           = "10.1029/2000jc000699"
+}
+
+@article{         egbert.ray_N00,
+  title         = "Significant dissipation of tidal energy in the deep ocean
+                  inferred from satellite altimeter data",
+  pages         = "775--778",
+  journal       = "Nature",
+  volume        = "405",
+  number        = "6788",
+  author        = "G. D. Egbert and R. D. Ray",
+  year          = "2000",
+  month         = "jun",
+  publisher     = "Springer Nature",
+  issn          = "1476-4687",
+  doi           = "10.1038/35015531"
+}
+
+@article{         eiseman.stone_SR80,
+  title         = "Conservation laws of fluid dynamics - {A} survey",
+  pages         = "12--27",
+  journal       = "SIAM Review",
+  volume        = "22",
+  number        = "1",
+  author        = "P. R. Eiseman and A. P. Stone",
+  year          = "1980",
+  month         = "jan",
+  publisher     = "Society for Industrial & Applied Mathematics (SIAM)",
+  issn          = "1095-7200",
+  doi           = "10.1137/1022002"
+}
+
+@article{         emile-geay.madec_OS09,
+  title         = "Geothermal heating, diapycnal mixing and the abyssal
+                  circulation",
+  pages         = "203--217",
+  journal       = "Ocean Science",
+  volume        = "5",
+  number        = "2",
+  author        = "J. Emile-Geay and G. Madec",
+  year          = "2009",
+  month         = "jun",
+  publisher     = "Copernicus GmbH",
+  issn          = "1812-0792",
+  doi           = "10.5194/os-5-203-2009"
+}
+
+@article{         engedahl_T95,
+  title         = "Use of the flow relaxation scheme in a three-dimensional
+                  baroclinic ocean model with realistic topography",
+  pages         = "365--382",
+  journal       = "Tellus A",
+  volume        = "47",
+  number        = "3",
+  author        = "H. Engedahl",
+  year          = "1995",
+  month         = "jan",
+  publisher     = "Informa UK Limited",
+  issn          = "1600-0870",
+  doi           = "10.3402/tellusa.v47i3.11523"
+}
+
+@article{ fairall.bradley.ea_JC03,
+title = "Bulk parameterization of air-sea fluxes: Updates and verification for the COARE algorithm",
+pages = "571--591",
+journal = "Journal of Climate",
+volume = "16",
+number = "4",
+author = "Fairall, C. W. and Bradley, E. F. and Hare, J. E. and Grachev, A. A. and Edson, J. B.",
+year = "2003",
+publisher = "American Meteorological Society",
+issn = "08948755",
+doi = "10.1175/1520-0442(2003)016<0571:BPOASF>2.0.CO;2"
+}
+
+@phdthesis{       farge-coulombier_phd87,
+  title         = "Dynamique non-lin\'{e}aire des ondes et des tourbillons
+                  dans les \'{e}quations de Saint-Venant",
+  pages         = "353",
+  author        = "M. {Farge Coulombier}",
+  school        = "Paris VI University, France",
+  year          = "1987",
+  url           = "http://www.theses.fr/1987PA066365"
+}
+
+@article{         farrow.stevens_JPO95,
+  title         = "A new tracer advection scheme for Bryan and Cox type Ocean
+                  General Circulation Models",
+  pages         = "1731--1741",
+  journal       = "Journal of Physical Oceanography",
+  volume        = "25",
+  number        = "7",
+  author        = "D. E. Farrow and D. P. Stevens",
+  year          = "1995",
+  month         = "jul",
+  publisher     = "American Meteorological Society",
+  issn          = "1520-0485",
+  doi           = "10.1175/1520-0485(1995)025<1731:antasf>2.0.co;2"
+}
+
+@article{         flather_JPO94,
+  title         = "A storm surge prediction model for the northern Bay of
+                  Bengal with application to the cyclone disaster in April
+                  1991",
+  pages         = "172--190",
+  journal       = "Journal of Physical Oceanography",
+  volume        = "24",
+  number        = "1",
+  author        = "R. A. Flather",
+  year          = "1994",
+  month         = "jan",
+  publisher     = "American Meteorological Society",
+  issn          = "1520-0485",
+  doi           = "10.1175/1520-0485(1994)024<0172:asspmf>2.0.co;2"
+}
+
+@book{            fofonoff.millard_bk83,
+  pages         = "53",
+  booktitle     = "Algorithms for computation of fundamental properties of
+                  seawater",
+  editor        = "UNESCO/ICES/SCOR/IAPSO",
+  series        = "Technical Paper in Marine Science",
+  volume        = "44",
+  author        = "N P. Fofonoff and R. C. Millard",
+  year          = "1983",
+  publisher     = "UNESCO",
+  url           = "https://unesdoc.unesco.org/ark:/48223/pf0000059832.locale=en"
+}
+
+@article{         foxkemper.ferrari_JPO08,
+  title         = "Parameterization of Mixed Layer Eddies. Part I: Theory and Diagnosis",
+  pages         = "1145--1165",
+  journal       = "Journal of Physical Oceanography",
+  volume        = "38",
+  number        = "6",
+  author        = "B. Fox-Kemper and R. Ferrari and B. Hallberg",
+  year          = "2008",
+  month         = "jun",
+  publisher     = "American Meteorological Society",
+  issn          = "1520-0485",
+  doi           = "10.1175/2007JPO3792.1"
+}
+
+@article{         galperin.kantha.ea_JAS88,
+  title         = "A quasi-equilibrium turbulent energy model for geophysical
+                  flows",
+  pages         = "55--62",
+  journal       = "Journal of the Atmospheric Sciences",
+  volume        = "45",
+  number        = "1",
+  author        = "B. Galperin and L. H. Kantha and S. Hassid and A. Rosati",
+  year          = "1988",
+  month         = "jan",
+  publisher     = "American Meteorological Society",
+  issn          = "1520-0469",
+  doi           = "10.1175/1520-0469(1988)045<0055:aqetem>2.0.co;2"
+}
+
+@article{         gargett_JMR84,
+  title         = "Vertical eddy diffusivity in the ocean interior",
+  pages         = "359--393",
+  journal       = "Journal of Marine Research",
+  volume        = "42",
+  number        = "2",
+  author        = "A. E. Gargett",
+  year          = "1984",
+  month         = "may",
+  publisher     = "Journal of Marine Research/Yale",
+  issn          = "1543-9542",
+  doi           = "10.1357/002224084788502756"
+}
+
+@article{         gaspar.gregoris.ea_JGR90,
+  title         = "A simple eddy kinetic energy model for simulations of the
+                  oceanic vertical mixing: Tests at station Papa and
+                  long-term upper ocean study site",
+  pages         = "16179",
+  journal       = "Journal of Geophysical Research",
+  volume        = "95",
+  number        = "C9",
+  author        = "P. Gaspar and Y. Gr{\'e}goris and J.-M. Lefevre",
+  year          = "1990",
+  publisher     = "American Geophysical Union (AGU)",
+  issn          = "0148-0227",
+  doi           = "10.1029/jc095ic09p16179"
+}
+
+@article{         gent.mcwilliams_JPO90,
+  title         = "Isopycnal Mixing in Ocean Circulation Models",
+  pages         = "150--155",
+  journal       = "Journal of Physical Oceanography",
+  volume        = "20",
+  number        = "1",
+  author        = "P. R. Gent and J. C. McWilliams",
+  year          = "1990",
+  month         = "jan",
+  publisher     = "American Meteorological Society",
+  issn          = "1520-0485",
+  doi           = "10.1175/1520-0485(1990)020<0150:imiocm>2.0.co;2"
+}
+
+@article{         gentemann.minnett.ea_JGR09,
+  title         = "Profiles of Ocean Surface Heating ({POSH}): {A} new model
+                  of upper ocean diurnal warming",
+  pages         = "C07017",
+  journal       = "Journal of Geophysical Research",
+  volume        = "114",
+  number        = "C7",
+  author        = "C. L. Gentemann and P. J. Minnett and B. Ward",
+  year          = "2009",
+  month         = "jul",
+  publisher     = "American Geophysical Union (AGU)",
+  issn          = "0148-0227",
+  doi           = "10.1029/2008jc004825"
+}
+
+@article{         gerdes.koberle.ea_CD91,
+  title         = "The influence of numerical advection schemes on the
+                  results of Ocean General Circulation Models",
+  pages         = "211--226",
+  journal       = "Climate Dynamics",
+  volume        = "5",
+  number        = "4",
+  author        = "R. Gerdes and C. K{\"{o}}berle and J. Willebrand",
+  year          = "1991",
+  month         = "jun",
+  publisher     = "Springer Nature",
+  issn          = "1432-0894",
+  doi           = "10.1007/bf00210006"
+}
+
+@article{         gerdes_JGR93*a,
+  title         = "A primitive equation ocean circulation model using a
+                  general vertical coordinate transformation: 1. Description
+                  and testing of the model",
+  pages         = "14683--14701",
+  journal       = "Journal of Geophysical Research",
+  volume        = "98",
+  number        = "C8",
+  author        = "R. Gerdes",
+  year          = "1993",
+  publisher     = "American Geophysical Union (AGU)",
+  issn          = "0148-0227",
+  doi           = "10.1029/93jc00760"
+}
+
+@article{         gerdes_JGR93*b,
+  title         = "A primitive equation ocean circulation model using a
+                  general vertical coordinate transformation: 2. Application
+                  to an overflow problem",
+  pages         = "14703--14726",
+  journal       = "Journal of Geophysical Research",
+  volume        = "98",
+  number        = "C8",
+  author        = "R. Gerdes",
+  year          = "1993",
+  publisher     = "American Geophysical Union (AGU)",
+  issn          = "0148-0227",
+  doi           = "10.1029/93jc00788"
+}
+
+@techreport{      gibson_rpt86,
+  title         = "Standards for software development and maintenance",
+  pages         = "21",
+  series        = "ECMWF Technical Memoranda",
+  number        = "120",
+  author        = "J. K. Gibson",
+  institution   = "ECMWF Operations Department; Reading, United Kingdom",
+  year          = "1986",
+  month         = "aug",
+  doi           = "10.21957/gi113q4gn"
+}
+
+@book{            gill_bk82,
+  pages         = "662",
+  booktitle     = "Atmosphere-Ocean Dynamics",
+  series        = "International Geophysics",
+  volume        = "30",
+  author        = "A. E. Gill",
+  year          = "1982",
+  month         = "nov",
+  publisher     = "Elsevier",
+  issn          = "0074-6142",
+  isbn          = "978-0-12-283522-3",
+  doi           = "10.1016/s0074-6142(08)x6002-4"
+}
+
+@article{         goff_JGR10,
+  title         = "Global prediction of abyssal hill root-mean-square heights
+                  from small-scale altimetric gravity variability",
+  pages         = "B12104",
+  journal       = "Journal of Geophysical Research",
+  volume        = "115",
+  number        = "B12",
+  author        = "J. A. Goff",
+  year          = "2010",
+  month         = "dec",
+  publisher     = "American Geophysical Union (AGU)",
+  issn          = "0148-0227",
+  doi           = "10.1029/2010jb007867"
+}
+
+@article{         goosse.deleersnijder.ea_JGR99,
+  title         = "Sensitivity of a global coupled ocean-sea ice model to the
+                  parameterization of vertical mixing",
+  pages         = "13681--13695",
+  journal       = "Journal of Geophysical Research",
+  volume        = "104",
+  number        = "C6",
+  author        = "H. Goosse and E. Deleersnijder and T. Fichefet and M. H.
+                  England",
+  year          = "1999",
+  month         = "jun",
+  publisher     = "American Geophysical Union (AGU)",
+  issn          = "0148-0227",
+  doi           = "10.1029/1999jc900099"
+}
+
+@article{         graham.mcdougall_JPO13,
+  title         = "Quantifying the nonconservative production of conservative
+                  temperature, potential temperature, and entropy",
+  pages         = "838--862",
+  journal       = "Journal of Physical Oceanography",
+  volume        = "43",
+  number        = "5",
+  author        = "F. S. Graham and T. J. McDougall",
+  year          = "2013",
+  month         = "may",
+  publisher     = "American Meteorological Society",
+  issn          = "1520-0485",
+  doi           = "10.1175/jpo-d-11-0188.1"
+}
+
+@article{         greatbatch_JGR94,
+  title         = "A note on the representation of steric sea level in models
+                  that conserve volume rather than mass",
+  pages         = "12767--12771",
+  journal       = "Journal of Geophysical Research",
+  volume        = "99",
+  number        = "C6",
+  author        = "R. J. Greatbatch",
+  year          = "1994",
+  publisher     = "American Geophysical Union (AGU)",
+  issn          = "0148-0227",
+  doi           = "10.1029/94jc00847"
+}
+
+@article{         griffies.biastoch.ea_OM09,
+  title         = "Coordinated Ocean-ice Reference Experiments ({CORE}s)",
+  pages         = "1--46",
+  journal       = "Ocean Modelling",
+  volume        = "26",
+  number        = "1-2",
+  author        = "S. M. Griffies and A. Biastoch and C. B{\"{o}}ning and F.
+                  Bryan and G. Danabasoglu and E. P. Chassignet and M. H.
+                  England and R. Gerdes and H. Haak and R. W. Hallberg and W.
+                  Hazeleger and J. Jungclaus and W. G. Large and G. Madec and
+                  A. Pirani and B. L. Samuels and M. Scheinert and A. Sen
+                  Gupta and C. A. Severijns and H. L. Simmons and A.-M.
+                  Tr\'{e}guier and M. Winton and S. Yeager and J. Yin",
+  year          = "2009",
+  month         = "jan",
+  publisher     = "Elsevier BV",
+  issn          = "1463-5003",
+  doi           = "10.1016/j.ocemod.2008.08.007"
+}
+
+@article{         griffies.gnanadesikan.ea_JPO98,
+  title         = "Isoneutral Diffusion in a z-coordinate Ocean Model",
+  pages         = "805--830",
+  journal       = "Journal of Physical Oceanography",
+  volume        = "28",
+  number        = "5",
+  author        = "S. M. Griffies and A. Gnanadesikan and R. C. Pacanowski
+                  and V. D. Larichev and J. K. Dukowicz and R. D. Smith",
+  year          = "1998",
+  month         = "may",
+  publisher     = "American Meteorological Society",
+  issn          = "1520-0485",
+  doi           = "10.1175/1520-0485(1998)028<0805:idiazc>2.0.co;2"
+}
+
+@article{         griffies.pacanowski.ea_MWR01,
+  title         = "Tracer Conservation with an Explicit Free Surface Method
+                  for z-coordinate Ocean Models",
+  pages         = "1081--1098",
+  journal       = "Monthly Weather Review",
+  volume        = "129",
+  number        = "5",
+  author        = "S. M. Griffies and R. C. Pacanowski and M. Schmidt and V.
+                  Balaji",
+  year          = "2001",
+  month         = "may",
+  publisher     = "American Meteorological Society",
+  issn          = "1520-0493",
+  doi           = "10.1175/1520-0493(2001)129<1081:tcwaef>2.0.co;2"
+}
+
+@article{         griffies_JPO98,
+  title         = "The Gent-McWilliams skew-flux",
+  pages         = "831--841",
+  journal       = "Journal of Physical Oceanography",
+  volume        = "28",
+  number        = "5",
+  author        = "S. M. Griffies",
+  year          = "1998",
+  month         = "may",
+  publisher     = "American Meteorological Society",
+  issn          = "1520-0485",
+  doi           = "10.1175/1520-0485(1998)028<0831:tgmsf>2.0.co;2"
+}
+
+@book{            griffies_bk04,
+  pages         = "434",
+  booktitle     = "Fundamentals of ocean climate models",
+  author        = "S. M. Griffies",
+  year          = "2004",
+  month         = "dec",
+  publisher     = "Princeton University Press",
+  isbn          = "978-0-691-18712-9",
+  doi           = "10.2307/j.ctv301gzg"
+}
+
+@article{         guilyardi.madec.ea_CD01,
+  title         = "The role of lateral ocean physics in the upper ocean
+                  thermal balance of a coupled ocean-atmosphere {GCM}",
+  pages         = "589--599",
+  journal       = "Climate Dynamics",
+  volume        = "17",
+  number        = "8",
+  author        = "E. Guilyardi and G. Madec and L. Terray",
+  year          = "2001",
+  month         = "may",
+  publisher     = "Springer Science and Business Media LLC",
+  issn          = "0930-7575",
+  doi           = "10.1007/pl00007930"
+}
+
+@article{         haney_JPO91,
+  title         = "On the Pressure Gradient Force over Steep Topography in
+                  Sigma Coordinate Ocean Models",
+  pages         = "610--619",
+  journal       = "Journal of Physical Oceanography",
+  volume        = "21",
+  number        = "4",
+  author        = "R. L. Haney",
+  year          = "1991",
+  month         = "apr",
+  publisher     = "American Meteorological Society",
+  issn          = "1520-0485",
+  doi           = "10.1175/1520-0485(1991)021<0610:otpgfo>2.0.co;2"
+}
+
+@article{         hazeleger.drijfhout_JGR00,
+  title         = "A model study on internally generated variability in
+                  subtropical mode water formation",
+  pages         = "13965--13979",
+  journal       = "Journal of Geophysical Research",
+  volume        = "105",
+  number        = "C6",
+  author        = "W. Hazeleger and S. S. Drijfhout",
+  year          = "2000",
+  month         = "jun",
+  publisher     = "American Geophysical Union (AGU)",
+  issn          = "0148-0227",
+  doi           = "10.1029/2000jc900041"
+}
+
+@article{         hazeleger.drijfhout_JPO00,
+  title         = "Eddy subduction in a model of the subtropical gyre",
+  pages         = "677--695",
+  journal       = "Journal of Physical Oceanography",
+  volume        = "30",
+  number        = "4",
+  author        = "W. Hazeleger and S. S. Drijfhout",
+  year          = "2000",
+  month         = "apr",
+  publisher     = "American Meteorological Society",
+  issn          = "1520-0485",
+  doi           = "10.1175/1520-0485(2000)030<0677:esiamo>2.0.co;2"
+}
+
+@article{         hazeleger.drijfhout_JPO98,
+  title         = "Mode water variability in a model of the subtropical gyre:
+                  response to anomalous forcing",
+  pages         = "266--288",
+  journal       = "Journal of Physical Oceanography",
+  volume        = "28",
+  number        = "2",
+  author        = "W. Hazeleger and S. S. Drijfhout",
+  year          = "1998",
+  month         = "feb",
+  publisher     = "American Meteorological Society",
+  issn          = "1520-0485",
+  doi           = "10.1175/1520-0485(1998)028<0266:mwviam>2.0.co;2"
+}
+
+@article{         hazeleger.drijfhout_JPO99,
+  title         = "Stochastically forced mode water variability",
+  pages         = "1772--1786",
+  journal       = "Journal of Physical Oceanography",
+  volume        = "29",
+  number        = "8",
+  author        = "W. Hazeleger and S. S. Drijfhout",
+  year          = "1999",
+  month         = "aug",
+  publisher     = "American Meteorological Society",
+  issn          = "1520-0485",
+  doi           = "10.1175/1520-0485(1999)029<1772:sfmwv>2.0.co;2"
+}
+
+@article{         he.ding_JS01,
+  title         = "Using accurate arithmetics to improve numerical
+                  reproducibility and stability in parallel applications",
+  pages         = "259--277",
+  journal       = "The Journal of Supercomputing",
+  volume        = "18",
+  number        = "3",
+  author        = "Y. He and C. H. Q. Ding",
+  year          = "2001",
+  publisher     = "Springer Nature",
+  issn          = "0920-8542",
+  doi           = "10.1023/a:1008153532043"
+}
+
+@article{         hirt.amsden.ea_JCP74,
+  title         = "An arbitrary Lagrangian-Eulerian computing method for all
+                  flow speeds",
+  pages         = "227--253",
+  journal       = "Journal of Computational Physics",
+  volume        = "14",
+  number        = "3",
+  author        = "C. W. Hirt and A. A. Amsden and J. L. Cook",
+  year          = "1974",
+  month         = "mar",
+  publisher     = "Elsevier BV",
+  issn          = "0021-9991",
+  doi           = "10.1016/0021-9991(74)90051-5"
+}
+
+@article{         hofmeister.burchard.ea_OM10,
+  title         = "Non-uniform adaptive vertical grids for 3{D} numerical
+                  ocean models",
+  pages         = "70--86",
+  journal       = "Ocean Modelling",
+  volume        = "33",
+  number        = "1-2",
+  author        = "R. Hofmeister and H. Burchard and J.-M. Beckers",
+  year          = "2010",
+  month         = "jan",
+  publisher     = "Elsevier BV",
+  issn          = "1463-5003",
+  doi           = "10.1016/j.ocemod.2009.12.003"
+}
+
+@article{         holland.jenkins_JPO99,
+  title         = "Modeling thermodynamic ice-ocean interactions at the base
+                  of an ice shelf",
+  pages         = "1787--1800",
+  journal       = "Journal of Physical Oceanography",
+  volume        = "29",
+  number        = "8",
+  author        = "D. M. Holland and A. Jenkins",
+  year          = "1999",
+  month         = "aug",
+  publisher     = "American Meteorological Society",
+  issn          = "1520-0485",
+  doi           = "10.1175/1520-0485(1999)029<1787:mtioia>2.0.co;2"
+}
+
+@techreport{      hunter_rpt06,
+  title         = "Specification for Test Models of Ice Shelf Cavities",
+  pages         = "17",
+  number        = "7",
+  author        = "J. R. Hunter",
+  institution   = "Antarctic Climate \& Ecosystems Cooperative Research
+                  Centre",
+  year          = "2006",
+  month         = "jun",
+  url           = "http://staff.acecrc.org.au/~bkgalton/ISOMIP/test_cavities.pdf"
+}
+
+@book{            ioc.iapso_bk10,
+  title         = "The international thermodynamic equation of seawater -
+                  2010: Calculation and use of thermodynamic properties",
+  pages         = "196",
+  editor        = "Intergovernmental Oceanographic Commission",
+  series        = "Manuals and Guides",
+  volume        = "56",
+  author        = "IOC, SCOR and IAPSO",
+  year          = "2010",
+  month         = "mar",
+  publisher     = "UNESCO",
+  url           = "https://unesdoc.unesco.org/ark:/48223/pf0000188170.locale=en"
+}
+
+@article{         jackson.rehmann_JPO14,
+  title         = "Experiments on differential scalar mixing in turbulence in
+                  a sheared, stratified flow",
+  pages         = "2661--2680",
+  journal       = "Journal of Physical Oceanography",
+  volume        = "44",
+  number        = "10",
+  author        = "P. R. Jackson and C. R. Rehmann",
+  year          = "2014",
+  month         = "oct",
+  publisher     = "American Meteorological Society",
+  issn          = "1520-0485",
+  doi           = "10.1175/jpo-d-14-0027.1"
+}
+
+@techreport{      janssen.breivik.ea_rpt13,
+  title         = "Air-sea interaction and surface waves",
+  pages         = "36",
+  series        = "ECMWF Technical Memoranda",
+  volume        = "712",
+  author        = "P. A. E. M. Janssen and {\O}. Breivik and K. Mogensen and
+                  F. Vitart and M. Alonso-Balmaseda and J.-R. Bidlot and S.
+                  Keeley and M. Leutbecher and L. Magnusson and F. Molteni",
+  institution   = "ECMWF Research Departement; Reading, United Kingdom",
+  year          = "2013",
+  month         = "nov",
+  doi           = "10.21957/0kg73joh"
+}
+
+@article{         jenkins.nicholls.ea_JPO10,
+  title         = "Observation and parameterization of ablation at the base
+                  of Ronne Ice Shelf, Antarctica",
+  pages         = "2298--2312",
+  journal       = "Journal of Physical Oceanography",
+  volume        = "40",
+  number        = "10",
+  author        = "A. Jenkins and K. W. Nicholls and H. F. J. Corr",
+  year          = "2010",
+  month         = "oct",
+  publisher     = "American Meteorological Society",
+  issn          = "1520-0485",
+  doi           = "10.1175/2010jpo4317.1"
+}
+
+@article{         jenkins_JGR91,
+  title         = "A one-dimensional model of ice shelf-ocean interaction",
+  pages         = "20671--20677",
+  journal       = "Journal of Geophysical Research",
+  volume        = "96",
+  number        = "C11",
+  author        = "A. Jenkins",
+  year          = "1991",
+  publisher     = "American Geophysical Union (AGU)",
+  issn          = "0148-0227",
+  doi           = "10.1029/91jc01842"
+}
+
+@article{         kantha.carniel_JMR03,
+  title         = "Comments on ``{A} generic length-scale equation for
+                  geophysical turbulence models'' by {L}. Umlauf and {H}.
+                  Burchard",
+  pages         = "693--702",
+  journal       = "Journal of Marine Research",
+  volume        = "61",
+  number        = "5",
+  author        = "L. Kantha and S. Carniel",
+  year          = "2003",
+  month         = "sep",
+  publisher     = "Journal of Marine Research/Yale",
+  issn          = "1543-9542",
+  doi           = "10.1357/002224003771816007"
+}
+
+@article{         kantha.clayson_JGR94,
+  title         = "An improved mixed layer model for geophysical
+                  applications",
+  pages         = "25235--25266",
+  journal       = "Journal of Geophysical Research",
+  volume        = "99",
+  number        = "C12",
+  author        = "L. H. Kantha and C. A. Clayson",
+  year          = "1994",
+  publisher     = "American Geophysical Union (AGU)",
+  issn          = "0148-0227",
+  doi           = "10.1029/94jc02257"
+}
+
+@article{         kasahara_MWR74,
+  title         = "Various vertical coordinate systems used for numerical
+                  weather prediction",
+  pages         = "509--522",
+  journal       = "Monthly Weather Review",
+  volume        = "102",
+  number        = "7",
+  author        = "A. Kasahara",
+  year          = "1974",
+  month         = "jul",
+  publisher     = "American Meteorological Society",
+  issn          = "1520-0493",
+  doi           = "10.1175/1520-0493(1974)102<0509:vvcsuf>2.0.co;2"
+}
+
+@article{         killworth.webb.ea_JPO91,
+  title         = "The development of a free-surface Bryan-Cox-Semtner ocean
+                  model",
+  pages         = "1333--1348",
+  journal       = "Journal of Physical Oceanography",
+  volume        = "21",
+  number        = "9",
+  author        = "P. D. Killworth and D. J. Webb and D. Stainforth and S. M.
+                  Paterson",
+  year          = "1991",
+  month         = "sep",
+  publisher     = "American Meteorological Society",
+  issn          = "1520-0485",
+  doi           = "10.1175/1520-0485(1991)021<1333:tdoafs>2.0.co;2"
+}
+
+@article{         killworth_JPO92,
+  title         = "An equivalent-barotropic mode in the fine resolution
+                  Antarctic model",
+  pages         = "1379--1387",
+  journal       = "Journal of Physical Oceanography",
+  volume        = "22",
+  number        = "11",
+  author        = "P. D. Killworth",
+  year          = "1992",
+  month         = "nov",
+  publisher     = "American Meteorological Society",
+  issn          = "1520-0485",
+  doi           = "10.1175/1520-0485(1992)022<1379:aebmit>2.0.co;2"
+}
+
+@inproceedings{   killworth_iprc89,
+  title         = "On the parameterization of deep convection in ocean
+                  models",
+  pages         = "59--74",
+  booktitle     = "Parameterization of small-scale processes",
+  editor        = "P. Muller and D. Henderson",
+  author        = "P. D. Killworth",
+  year          = "1989",
+  month         = "jan",
+  publisher     = "Hawaii Institute of Geophysics",
+  url           = "http://www.soest.hawaii.edu/PubServices/1989pdfs/Killworth.pdf"
+}
+
+@article{         koch-larrouy.lengaigne.ea_CD10,
+  title         = "Tidal mixing in the Indonesian Seas and its effect on the
+                  tropical climate system",
+  pages         = "891--904",
+  journal       = "Climate Dynamics",
+  volume        = "34",
+  number        = "6",
+  author        = "A. Koch-Larrouy and M. Lengaigne and P. Terray and G.
+                  Madec and S. Masson",
+  year          = "2010",
+  month         = "aug",
+  publisher     = "Springer Nature",
+  issn          = "1432-0894",
+  doi           = "10.1007/s00382-009-0642-4"
+}
+
+@article{         koch-larrouy.madec.ea_GRL07,
+  title         = "On the transformation of Pacific water into Indonesian
+                  ThroughFlow water by internal tidal mixing",
+  pages         = "L04604",
+  journal       = "Geophysical Research Letters",
+  volume        = "34",
+  number        = "4",
+  author        = "A. Koch-Larrouy and G. Madec and P. Bouruet-Aubertot and
+                  T. Gerkema and L. Bessi\`{e}res and R. Molcard",
+  year          = "2007",
+  month         = "feb",
+  publisher     = "American Geophysical Union (AGU)",
+  issn          = "0094-8276",
+  doi           = "10.1029/2006gl028405"
+}
+
+@article{         koch-larrouy.madec.ea_OD08*a,
+  title         = "Water mass transformation along the Indonesian ThroughFlow
+                  in an {OGCM}",
+  pages         = "289--309",
+  journal       = "Ocean Dynamics",
+  volume        = "58",
+  number        = "3-4",
+  author        = "A. Koch-Larrouy and G. Madec and B. Blanke and R. Molcard",
+  year          = "2008",
+  month         = "oct",
+  publisher     = "Springer Nature",
+  issn          = "1616-7228",
+  doi           = "10.1007/s10236-008-0155-4"
+}
+
+@article{         koch-larrouy.madec.ea_OD08*b,
+  title         = "Physical processes contributing to the water mass
+                  transformation of the Indonesian ThroughFlow",
+  pages         = "275--288",
+  journal       = "Ocean Dynamics",
+  volume        = "58",
+  number        = "3-4",
+  author        = "A. Koch-Larrouy and G. Madec and D. Iudicone and A.
+                  Atmadipoera and R. Molcard",
+  year          = "2008",
+  month         = "oct",
+  publisher     = "Springer Nature",
+  issn          = "1616-7228",
+  doi           = "10.1007/s10236-008-0154-5"
+}
+
+@article{         kolmogorov_IANS42,
+  title         = "Equations of turbulent motion in an incompressible fluid",
+  pages         = "56--58",
+  journal       = "Izvestiya Akademiya Nauk SSSR",
+  series        = "Fizika",
+  volume        = "6",
+  author        = "A. N. Kolmogorov",
+  year          = "1942"
+}
+
+@techreport{      large.yeager_rpt04,
+  title         = "Diurnal to decadal global forcing for ocean and sea-ice
+                  models: the data sets and flux climatologies",
+  author        = "W. G. Large and S. G. Yeager",
+  institution   = "{NCAR} Climate and global dynamics division; Boulder, CO,
+                  United States",
+  year          = "2004",
+  month         = "may",
+  doi           = "10.5065/d6kk98q6"
+}
+
+@article{         lazar.madec.ea_JPO99,
+  title         = "The Deep Interior Downwelling, the Veronis Effect, and
+                  Mesoscale Tracer Transport Parameterizations in an {OGCM}",
+  pages         = "2945--2961",
+  journal       = "Journal of Physical Oceanography",
+  volume        = "29",
+  number        = "11",
+  author        = "A. Lazar and G. Madec and P. Del\'{e}cluse",
+  year          = "1999",
+  month         = "nov",
+  publisher     = "American Meteorological Society",
+  issn          = "1520-0485",
+  doi           = "10.1175/1520-0485(1999)029<2945:tdidtv>2.0.co;2"
+}
+
+@phdthesis{       lazar_phd97,
+  title         = "La branche froide de la circulation thermohaline -
+                  sensibilit\'{e} \`{a} la diffusion turbulente dans un
+                  mod\`{e}le de circulation g\'{e}n\'{e}rale
+                  id\'{e}alis\'{e}e",
+  pages         = "269",
+  author        = "A. Lazar",
+  school        = "Universit\'{e} Pierre et Marie Curie, Paris, France",
+  year          = "1997",
+  url           = "http://www.theses.fr/1997PA066680"
+}
+
+@article{         le-sommer.penduff.ea_OM09,
+  title         = "How momentum advection schemes influence
+                  current-topography interactions at eddy permitting
+                  resolution",
+  pages         = "1--14",
+  journal       = "Ocean Modelling",
+  volume        = "29",
+  number        = "1",
+  author        = "J. {Le Sommer} and T. Penduff and S. Theetten and G. Madec
+                  and B. Barnier",
+  year          = "2009",
+  month         = "jan",
+  publisher     = "Elsevier BV",
+  issn          = "1463-5003",
+  doi           = "10.1016/j.ocemod.2008.11.007"
+}
+
+@article{         leclair.madec_OM09,
+  title         = "A conservative leapfrog time stepping method",
+  pages         = "88--94",
+  journal       = "Ocean Modelling",
+  volume        = "30",
+  number        = "2-3",
+  author        = "M. Leclair and G. Madec",
+  year          = "2009",
+  month         = "jan",
+  publisher     = "Elsevier BV",
+  issn          = "1463-5003",
+  doi           = "10.1016/j.ocemod.2009.06.006"
+}
+
+@article{         leclair.madec_OM11,
+  title         = "$\tilde{z}$-coordinate, an arbitrary Lagrangian-Eulerian
+                  coordinate separating high and low frequency motions",
+  pages         = "139--152",
+  journal       = "Ocean Modelling",
+  volume        = "37",
+  number        = "3-4",
+  author        = "M. Leclair and G. Madec",
+  year          = "2011",
+  publisher     = "Elsevier BV",
+  issn          = "1463-5003",
+  doi           = "10.1016/j.ocemod.2011.02.001"
+}
+
+@phdthesis{       leclair_phd10,
+  title         = "Introduction d'une coordonn\'{e}e verticale arbitrairement
+                  Lagrangienne Eul\'{e}rienne dans le code d'oc\'{e}an
+                  {NEMO}",
+  pages         = "163",
+  author        = "M. Leclair",
+  school        = "Universit\'{e} Pierre and Marie Curie, Paris, France",
+  year          = "2010",
+  url           = "http://www.theses.fr/2010PA066728"
+}
+
+@article{         lele_JCP92,
+  title         = "Compact finite difference schemes with spectral-like
+                  resolution",
+  pages         = "16--42",
+  journal       = "Journal of Computational Physics",
+  volume        = "103",
+  number        = "1",
+  author        = "S. K. Lele",
+  year          = "1992",
+  month         = "nov",
+  publisher     = "Elsevier BV",
+  issn          = "0021-9991",
+  doi           = "10.1016/0021-9991(92)90324-r"
+}
+
+@article{         lemarie.debreu.ea_OM12,
+  title         = "On the stability and accuracy of the harmonic and
+                  biharmonic isoneutral mixing operators in ocean models",
+  pages         = "9--35",
+  journal       = "Ocean Modelling",
+  volume        = "52-53",
+  author        = "F. Lemari\'{e} and L. Debreu and A. F. Shchepetkin and J.
+                  C. McWilliams",
+  year          = "2012",
+  month         = "aug",
+  publisher     = "Elsevier BV",
+  issn          = "1463-5003",
+  doi           = "10.1016/j.ocemod.2012.04.007"
+}
+
+@article{         lemarie.debreu.ea_OM15,
+  title         = "Stability constraints for oceanic numerical models:
+                  implications for the formulation of time and space
+                  discretizations",
+  pages         = "124--148",
+  journal       = "Ocean Modelling",
+  volume        = "92",
+  author        = "F. Lemari\'{e} and L. Debreu and G. Madec and J. Demange
+                  and J. M. Molines and M. Honnorat",
+  year          = "2015",
+  month         = "aug",
+  publisher     = "Elsevier BV",
+  issn          = "1463-5003",
+  doi           = "10.1016/j.ocemod.2015.06.006"
+}
+
+@article{         lengaigne.madec.ea_JGR03,
+  title         = "Impact of isopycnal mixing on the tropical ocean
+                  circulation",
+  pages         = "3345",
+  journal       = "Journal of Geophysical Research",
+  volume        = "108",
+  number        = "C11",
+  author        = "M. Lengaigne and G. Madec and G. Alory and C. Menkes",
+  year          = "2003",
+  publisher     = "American Geophysical Union (AGU)",
+  issn          = "0148-0227",
+  doi           = "10.1029/2002jc001704"
+}
+
+@article{         lengaigne.menkes.ea_CD07,
+  title         = "Influence of the oceanic biology on the tropical Pacific
+                  climate in a Coupled General Circulation Model",
+  pages         = "503--516",
+  journal       = "Climate Dynamics",
+  volume        = "28",
+  number        = "5",
+  author        = "M. Lengaigne and C. Menkes and O. Aumont and T. Gorgues
+                  and L. Bopp and J.-M. Andr\'{e} and G. Madec",
+  year          = "2007",
+  month         = "nov",
+  publisher     = "Springer Nature",
+  issn          = "1432-0894",
+  doi           = "10.1007/s00382-006-0200-2"
+}
+
+@article{         leonard_CMAME79,
+  title         = "A stable and accurate convective modelling procedure based
+                  on quadratic upstream interpolation",
+  pages         = "59--98",
+  journal       = "Computer Methods in Applied Mechanics and Engineering",
+  volume        = "19",
+  number        = "1",
+  author        = "B. P. Leonard",
+  year          = "1979",
+  month         = "jun",
+  publisher     = "Elsevier BV",
+  issn          = "0045-7825",
+  doi           = "10.1016/0045-7825(79)90034-3"
+}
+
+@article{         leonard_CMAME91,
+  title         = "The {ULTIMATE} conservative difference scheme applied to
+                  unsteady one-dimensional advection",
+  pages         = "17--74",
+  journal       = "Computer Methods in Applied Mechanics and Engineering",
+  volume        = "88",
+  number        = "1",
+  author        = "B. P. Leonard",
+  year          = "1991",
+  month         = "jun",
+  publisher     = "Elsevier BV",
+  issn          = "0045-7825",
+  doi           = "10.1016/0045-7825(91)90232-u"
+}
+
+@article{         lermusiaux_JMS01,
+  title         = "Evolving the subspace of the three-dimensional multiscale
+                  ocean variability: Massachusetts Bay",
+  pages         = "385--422",
+  journal       = "Journal of Marine Systems",
+  volume        = "29",
+  number        = "1-4",
+  author        = "P. F. J. Lermusiaux",
+  year          = "2001",
+  month         = "may",
+  publisher     = "Elsevier BV",
+  issn          = "0924-7963",
+  doi           = "10.1016/s0924-7963(01)00025-2"
+}
+
+@techreport{      levier.treguier.ea_rpt07,
+  title         = "Free surface and variable volume in the {NEMO} code",
+  pages         = "47",
+  author        = "B. Levier and A.-M. Tr\'{e}guier and G. Madec and V.
+                  Garnier",
+  institution   = "European Union: Marine Environment and Security for the
+                  European Area (MERSEA) Integrated Project",
+  year          = "2007",
+  month         = "may",
+  doi           = "10.5281/zenodo.3244182"
+}
+
+@article{         levy.estublier.ea_GRL01,
+  title         = "Choice of an advection scheme for biogeochemical models",
+  pages         = "3725--3728",
+  journal       = "Geophysical Research Letters",
+  volume        = "28",
+  number        = "19",
+  author        = "M. L\'{e}vy and A. Estublier and G Madec",
+  year          = "2001",
+  month         = "oct",
+  publisher     = "American Geophysical Union (AGU)",
+  issn          = "0094-8276",
+  doi           = "10.1029/2001gl012947"
+}
+
+@article{         levy.klein.ea_OM10,
+  title         = "Modifications of gyre circulation by sub-mesoscale
+                  physics",
+  pages         = "1--15",
+  journal       = "Ocean Modelling",
+  volume        = "34",
+  number        = "1-2",
+  author        = "M. L\'{e}vy and P. Klein and A.-M. Tr\'{e}guier and D.
+                  Iovino and G. Madec and S. Masson and K. Takahashi",
+  year          = "2010",
+  month         = "jan",
+  publisher     = "Elsevier BV",
+  issn          = "1463-5003",
+  doi           = "10.1016/j.ocemod.2010.04.001"
+}
+
+@article{         li.garrett_JMR93,
+  title         = "Cell merging and the jet/downwelling ratio in Langmuir
+                  circulation",
+  pages         = "737--769",
+  journal       = "Journal of Marine Research",
+  volume        = "51",
+  number        = "4",
+  author        = "M. Li and C. Garrett",
+  year          = "1993",
+  month         = "nov",
+  publisher     = "Journal of Marine Research/Yale",
+  issn          = "1543-9542",
+  doi           = "10.1357/0022240933223945"
+}
+
+@article{         losch_JGR08,
+  title         = "Modeling ice shelf cavities in a z coordinate Ocean
+                  General Circulation Model",
+  journal       = "Journal of Geophysical Research",
+  volume        = "113",
+  number        = "C8",
+  author        = "M. Losch",
+  year          = "2008",
+  month         = "aug",
+  publisher     = "American Geophysical Union (AGU)",
+  issn          = "0148-0227",
+  doi           = "10.1029/2007jc004368"
+}
+
+@article{         lott.madec.ea_OM90,
+  title         = "Topographic experiments in an Ocean General Circulation
+                  Model",
+  pages         = "1--4",
+  journal       = "Ocean Modelling",
+  volume        = "88",
+  author        = "F. Lott and G. Madec and J. Verron",
+  year          = "1990"
+}
+
+@article{	  lupkes.gryanik.ea_JGR12,
+  author 	= "L{\"{u}}pkes, Christof and Gryanik, Vladimir M. and Hartmann, J{\"{o}}rg and Andreas, Edgar L.",
+  doi 		= "10.1029/2012JD017630",
+  issn 		= "01480227",
+  journal 	= "Journal of Geophysical Research Atmospheres",
+  number 	= "13",
+  pages 	= "1--18",
+  title 	= "A parametrization, based on sea ice morphology, of the neutral atmospheric drag coefficients for weather prediction and climate models",
+  volume 	= "117",
+  year 		= "2012"
+}
+
+@article{	  lupkes.gryanik_JGR15,
+  author 	= "L{\"{u}}pkes, Christof and Gryanik, Vladimir M.",
+  doi 		= "10.1002/2014JD022418",
+  issn 		= "21562202",
+  journal 	= "Journal of Geophysical Research",
+  number 	= "2",
+  pages 	= "552--581",
+  title 	= "A stability-dependent parametrization of transfer coefficients formomentum and heat over polar sea ice to be used in climate models",
+  volume 	= "120",
+  year 		= "2015"
+}
+
+@article{         madec.chartier.ea_DAO91,
+  title         = "The effect of thermohaline forcing variability on deep
+                  water formation in the western Mediterranean Sea: a
+                  high-resolution three-dimensional numerical study",
+  pages         = "301--332",
+  journal       = "Dynamics of Atmospheres and Oceans",
+  volume        = "15",
+  number        = "3-5",
+  author        = "G. Madec and M. Chartier and M. Cr\'{e}pon",
+  year          = "1991",
+  month         = "apr",
+  publisher     = "Elsevier BV",
+  issn          = "0377-0265",
+  doi           = "10.1016/0377-0265(91)90024-a"
+}
+
+@inproceedings{   madec.crepon_iprc91,
+  title         = "Thermohaline-driven deep water formation in the
+                  northwestern Mediterranean Sea",
+  chapter       = "15",
+  pages         = "241--265",
+  booktitle     = "Deep convection and deep water formation in the oceans,
+                  Proceedings of the international Monterey colloquium on
+                  deep convection and deep water formation in the oceans",
+  editor        = "P.C. Chu and J.C. Gascard",
+  series        = "Elsevier Oceanography",
+  volume        = "57",
+  author        = "G. Madec and M. Cr\'{e}pon",
+  year          = "1991",
+  publisher     = "Elsevier",
+  issn          = "0422-9894",
+  isbn          = "978-0-444-88764-1",
+  doi           = "10.1016/s0422-9894(08)70071-0"
+}
+
+@article{         madec.delecluse.ea_JPO91,
+  title         = "A three-dimensional numerical study of deep-water
+                  formation in the northwestern Mediterranean Sea",
+  pages         = "1349--1371",
+  journal       = "Journal of Physical Oceanography",
+  volume        = "21",
+  number        = "9",
+  author        = "G. Madec and P. Del\'{e}cluse and M. Cr\'{e}pon and M.
+                  Chartier",
+  year          = "1991",
+  month         = "sep",
+  publisher     = "American Meteorological Society",
+  issn          = "1520-0485",
+  doi           = "10.1175/1520-0485(1991)021<1349:atdnso>2.0.co;2"
+}
+
+@article{         madec.delecluse.ea_JPO96,
+  title         = "Large-Scale Preconditioning of Deep-Water Formation in the
+                  northwestern Mediterranean Sea",
+  pages         = "1393--1408",
+  journal       = "Journal of Physical Oceanography",
+  volume        = "26",
+  number        = "8",
+  author        = "G. Madec and P. Del\'{e}cluse and M. Cr\'{e}pon and F.
+                  Lott",
+  year          = "1996",
+  month         = "aug",
+  publisher     = "American Meteorological Society",
+  issn          = "1520-0485",
+  doi           = "10.1175/1520-0485(1996)026<1393:lspodw>2.0.co;2"
+}
+
+@book{            madec.delecluse.ea_NPM98,
+  title         = "{OPA} 8.1 Ocean General Circulation Model reference
+                  manual",
+  pages         = "91",
+  journal       = "Note du Pole de Mod\'{e}lisation",
+  volume        = "11",
+  author        = "G. Madec and P. Del\'{e}cluse and M. Imbard and C.
+                  L\'{e}vy",
+  year          = "1998",
+  publisher     = "Institut Pierre Simon Laplace ({IPSL})",
+  issn          = "1288-1619",
+  url           = "http://cmc.ipsl.fr/images/publications/scientific_notes/note11.pdf"
+}
+
+@article{         madec.delecluse_IWN97,
+  title         = "The {OPA}/{ARPEGE} and {OPA}/{LMD} Global Ocean-Atmosphere
+                  Coupled Model",
+  pages         = "12--15",
+  journal       = "International WOCE Newsletter",
+  volume        = "26",
+  author        = "G. Madec and P. Del\'{e}cluse",
+  year          = "1997",
+  month         = "apr",
+  publisher     = "University of Southampton",
+  url           = "https://www.nodc.noaa.gov/woce/wdiu/wocedocs/newsltr/news26/news26.pdf"
+}
+
+@article{         madec.imbard_CD96,
+  title         = "A global ocean mesh to overcome the North Pole
+                  singularity",
+  pages         = "381--388",
+  journal       = "Climate Dynamics",
+  volume        = "12",
+  number        = "6",
+  author        = "G. Madec and M. Imbard",
+  year          = "1996",
+  month         = "may",
+  publisher     = "Springer Nature",
+  issn          = "1432-0894",
+  doi           = "10.1007/bf00211684"
+}
+
+@article{         maltrud.smith.ea_JGR98,
+  title         = "Global eddy-resolving ocean simulations driven by
+                  1985-1995 atmospheric winds",
+  pages         = "30825--30853",
+  journal       = "Journal of Geophysical Research",
+  volume        = "103",
+  number        = "C13",
+  author        = "M. E. Maltrud and R. D. Smith and A. J. Semtner and R. C.
+                  Malone",
+  year          = "1998",
+  month         = "dec",
+  publisher     = "American Geophysical Union (AGU)",
+  issn          = "0148-0227",
+  doi           = "10.1029/1998jc900013"
+}
+
+@article{         marchesiello.mcwilliams.ea_OM01,
+  title         = "Open boundary conditions for long-term integration of
+                  regional oceanic models",
+  pages         = "1--20",
+  journal       = "Ocean Modelling",
+  volume        = "3",
+  number        = "1-2",
+  author        = "P. Marchesiello and J. C. McWilliams and A. Shchepetkin",
+  year          = "2001",
+  month         = "jan",
+  publisher     = "Elsevier BV",
+  issn          = "1463-5003",
+  doi           = "10.1016/s1463-5003(00)00013-5"
+}
+
+@article{         marsaleix.auclair.ea_OM08,
+  title         = "Energy conservation issues in sigma-coordinate
+                  free-surface ocean models",
+  pages         = "61--89",
+  journal       = "Ocean Modelling",
+  volume        = "20",
+  number        = "1",
+  author        = "P. Marsaleix and F. Auclair and J. W. Floor and M. J.
+                  Herrmann and C. Estournel and I. Pairaud and C. Ulses",
+  year          = "2008",
+  month         = "jan",
+  publisher     = "Elsevier BV",
+  issn          = "1463-5003",
+  doi           = "10.1016/j.ocemod.2007.07.005"
+}
+
+@article{         marsh.ivchenko.ea_GMD15,
+  title         = "{NEMO}-{ICB} (v1.0): interactive icebergs in the {NEMO}
+                  ocean model globally configured at eddy-permitting
+                  resolution",
+  pages         = "1547--1562",
+  journal       = "Geoscientific Model Development",
+  volume        = "8",
+  number        = "5",
+  author        = "R. Marsh and V. O. Ivchenko and N. Skliris and S. Alderson
+                  and G. R. Bigg and G. Madec and A. T. Blaker and Y. Aksenov
+                  and B. Sinha and A. C. Coward and J. {Le Sommer} and N.
+                  Merino and V. B. Zalesny",
+  year          = "2015",
+  month         = "may",
+  publisher     = "Copernicus GmbH",
+  issn          = "1991-9603",
+  doi           = "10.5194/gmd-8-1547-2015"
+}
+
+@article{         marti.madec.ea_JGR92,
+  title         = "Comment on ``{N}et diffusivity in ocean general
+                  circulation models with nonuniform grids'' by {F}. {L}. Yin
+                  and {I}. {Y}. Fung",
+  pages         = "12763--12766",
+  journal       = "Journal of Geophysical Research",
+  volume        = "97",
+  number        = "C8",
+  author        = "O. Marti and G. Madec and P. Del\'{e}cluse",
+  year          = "1992",
+  publisher     = "American Geophysical Union (AGU)",
+  issn          = "0148-0227",
+  doi           = "10.1029/92jc00306"
+}
+
+@article{         martin.adcroft_OM10,
+  title         = "Parameterizing the fresh-water flux from land ice to ocean
+                  with interactive icebergs in a coupled climate model",
+  pages         = "111--124",
+  journal       = "Ocean Modelling",
+  volume        = "34",
+  number        = "3-4",
+  author        = "T. Martin and A. Adcroft",
+  year          = "2010",
+  month         = "jan",
+  publisher     = "Elsevier BV",
+  issn          = "1463-5003",
+  doi           = "10.1016/j.ocemod.2010.05.001"
+}
+
+@article{         mathiot.jenkins.ea_GMD17,
+  title         = "Explicit representation and parametrised impacts of under
+                  ice shelf seas in the \zstar coordinate ocean model {NEMO}
+                  3.6",
+  pages         = "2849--2874",
+  journal       = "Geoscientific Model Development",
+  volume        = "10",
+  number        = "7",
+  author        = "P. Mathiot and A. Jenkins and C. Harris and G. Madec",
+  year          = "2017",
+  month         = "jul",
+  publisher     = "Copernicus GmbH",
+  issn          = "1991-9603",
+  doi           = "10.5194/gmd-10-2849-2017"
+}
+
+@article{         mcdougall.taylor_JMR84,
+  title         = "Flux measurements across a finger interface at low values
+                  of the stability ratio",
+  pages         = "1--14",
+  journal       = "Journal of Marine Research",
+  volume        = "42",
+  number        = "1",
+  author        = "T. J. McDougall and J. R. Taylor",
+  year          = "1984",
+  month         = "feb",
+  publisher     = "Journal of Marine Research/Yale",
+  issn          = "1543-9542",
+  doi           = "10.1357/002224084788506095"
+}
+
+@article{         mcdougall_JPO87,
+  title         = "Neutral Surfaces",
+  pages         = "1950--1964",
+  journal       = "Journal of Physical Oceanography",
+  volume        = "17",
+  number        = "11",
+  author        = "T. J. McDougall",
+  year          = "1987",
+  month         = "nov",
+  publisher     = "American Meteorological Society",
+  issn          = "1520-0485",
+  doi           = "10.1175/1520-0485(1987)017<1950:ns>2.0.co;2"
+}
+
+@article{         mellor.blumberg_JPO04,
+  title         = "Wave Breaking and Ocean Surface Layer Thermal Response",
+  pages         = "693--698",
+  journal       = "Journal of Physical Oceanography",
+  volume        = "34",
+  number        = "3",
+  author        = "G. Mellor and A. Blumberg",
+  year          = "2004",
+  month         = "mar",
+  publisher     = "American Meteorological Society",
+  issn          = "1520-0485",
+  doi           = "10.1175/2517.1"
+}
+
+@article{         mellor.yamada_RG82,
+  title         = "Development of a turbulence closure model for geophysical
+                  fluid problems",
+  pages         = "851--875",
+  journal       = "Reviews of Geophysics",
+  volume        = "20",
+  number        = "4",
+  author        = "G. L. Mellor and T. Yamada",
+  year          = "1982",
+  publisher     = "American Geophysical Union (AGU)",
+  issn          = "8755-1209",
+  doi           = "10.1029/rg020i004p00851"
+}
+
+@article{         merryfield.holloway.ea_JPO99,
+  title         = "A Global Ocean Model with Double-Diffusive Mixing",
+  pages         = "1124--1142",
+  journal       = "Journal of Physical Oceanography",
+  volume        = "29",
+  number        = "6",
+  author        = "W. J. Merryfield and G. Holloway and A. E. Gargett",
+  year          = "1999",
+  month         = "jun",
+  publisher     = "American Meteorological Society",
+  issn          = "1520-0485",
+  doi           = "10.1175/1520-0485(1999)029<1124:agomwd>2.0.co;2"
+}
+
+@book{            mesinger.arakawa_bk76,
+  booktitle     = "Numerical methods used in atmospheric models",
+  series        = "GARP Publication",
+  volume        = "1",
+  number        = "17",
+  author        = "F. Mesinger and A. Arakawa",
+  year          = "1976",
+  month         = "aug",
+  url           = "https://www.researchgate.net/publication/234333726_Numerical_Methods_Used_In_Atmospheric_Models"
+}
+
+@article{         morel.berthon_LO89,
+  title         = "Surface pigments, algal biomass profiles, and potential
+                  production of the euphotic layer: Relationships
+                  reinvestigated in view of remote-sensing applications",
+  pages         = "1545--1562",
+  journal       = "Limnology and Oceanography",
+  volume        = "34",
+  number        = "8",
+  author        = "A. Morel and J.-F. Berthon",
+  year          = "1989",
+  month         = "dec",
+  publisher     = "Wiley",
+  issn          = "0024-3590",
+  doi           = "10.4319/lo.1989.34.8.1545"
+}
+
+@article{         morel.maritorena_JGR01,
+  title         = "Bio-optical properties of oceanic waters: {A} reappraisal",
+  pages         = "7163--7180",
+  journal       = "Journal of Geophysical Research",
+  volume        = "106",
+  number        = "C4",
+  author        = "A. Morel and S. Maritorena",
+  year          = "2001",
+  month         = "apr",
+  publisher     = "American Geophysical Union (AGU)",
+  issn          = "0148-0227",
+  doi           = "10.1029/2000jc000319"
+}
+
+@article{         morel_JGR88,
+  title         = "Optical modeling of the upper ocean in relation to its
+                  biogenous matter content (case {I} waters)",
+  pages         = "10749--10768",
+  journal       = "Journal of Geophysical Research",
+  volume        = "93",
+  number        = "C9",
+  author        = "A. Morel",
+  year          = "1988",
+  publisher     = "American Geophysical Union (AGU)",
+  issn          = "0148-0227",
+  doi           = "10.1029/jc093ic09p10749"
+}
+
+@article{         murray_JCP96,
+  title         = "Explicit Generation of Orthogonal Grids for Ocean Models",
+  pages         = "251--273",
+  journal       = "Journal of Computational Physics",
+  volume        = "126",
+  number        = "2",
+  author        = "R. J. Murray",
+  year          = "1996",
+  month         = "jul",
+  publisher     = "Elsevier BV",
+  issn          = "0021-9991",
+  doi           = "10.1006/jcph.1996.0136"
+}
+
+@article{         oey_OM06,
+  title         = "An {OGCM} with movable land-sea boundaries",
+  pages         = "176--195",
+  journal       = "Ocean Modelling",
+  volume        = "13",
+  number        = "2",
+  author        = "L.-Y. Oey",
+  year          = "2006",
+  month         = "jan",
+  publisher     = "Elsevier BV",
+  issn          = "1463-5003",
+  doi           = "10.1016/j.ocemod.2006.01.001"
+}
+
+@article{         osborn_JPO80,
+  title         = "Estimates of the local rate of vertical diffusion from
+                  dissipation measurements",
+  pages         = "83--89",
+  journal       = "Journal of Physical Oceanography",
+  volume        = "10",
+  number        = "1",
+  author        = "T. R. Osborn",
+  year          = "1980",
+  month         = "jan",
+  publisher     = "American Meteorological Society",
+  issn          = "1520-0485",
+  doi           = "10.1175/1520-0485(1980)010<0083:eotlro>2.0.co;2"
+}
+
+@article{         pacanowski.gnanadesikan_MWR98,
+  title         = "Transient response in a z-level ocean model that resolves
+                  topography with partial-cells",
+  pages         = "3248--3270",
+  journal       = "Monthly Weather Review",
+  volume        = "126",
+  number        = "12",
+  author        = "R. C. Pacanowski and A. Gnanadesikan",
+  year          = "1998",
+  month         = "dec",
+  publisher     = "American Meteorological Society",
+  issn          = "1520-0493",
+  doi           = "10.1175/1520-0493(1998)126<3248:triazl>2.0.co;2"
+}
+
+@article{         pacanowski.philander_JPO81,
+  title         = "Parameterization of Vertical Mixing in Numerical Models of
+                  Tropical Oceans",
+  pages         = "1443--1451",
+  journal       = "Journal of Physical Oceanography",
+  volume        = "11",
+  number        = "11",
+  author        = "R. C. Pacanowski and S. G. H. Philander",
+  year          = "1981",
+  month         = "nov",
+  publisher     = "American Meteorological Society",
+  issn          = "1520-0485",
+  doi           = "10.1175/1520-0485(1981)011<1443:povmin>2.0.co;2"
+}
+
+@article{         paulson.simpson_JPO77,
+  title         = "Irradiance Measurements in the Upper Ocean",
+  pages         = "952--956",
+  journal       = "Journal of Physical Oceanography",
+  volume        = "7",
+  number        = "6",
+  author        = "C. A. Paulson and J. J. Simpson",
+  year          = "1977",
+  month         = "nov",
+  publisher     = "American Meteorological Society",
+  issn          = "1520-0485",
+  doi           = "10.1175/1520-0485(1977)007<0952:imituo>2.0.co;2"
+}
+
+@article{         penduff.le-sommer.ea_OS07,
+  title         = "Influence of numerical schemes on current-topography
+                  interactions in 1/4\deg global ocean simulations",
+  pages         = "509--524",
+  journal       = "Ocean Science",
+  volume        = "3",
+  number        = "4",
+  author        = "T. Penduff and J. {Le Sommer} and B. Barnier and A.-M.
+                  Tr\'{e}guier and J.-M. Molines and G. Madec",
+  year          = "2007",
+  month         = "dec",
+  publisher     = "Copernicus GmbH",
+  issn          = "1812-0792",
+  doi           = "10.5194/os-3-509-2007"
+}
+
+@article{         phillips_TAMS59,
+  title         = "Dissipative operators and hyperbolic systems of partial
+                  differential equations",
+  pages         = "193--254",
+  journal       = "Transactions of the American Mathematical Society",
+  volume        = "90",
+  number        = "2",
+  author        = "R. S. Phillips",
+  year          = "1959",
+  month         = "feb",
+  publisher     = "American Mathematical Society (AMS)",
+  issn          = "0002-9947",
+  doi           = "10.1090/s0002-9947-1959-0104919-1"
+}
+
+@article{         qiao.yuan.ea_OD10,
+  title         = "A three-dimensional surface wave–ocean circulation coupled 
+                  model and its initial testing",
+  pages         = "1339--1335",
+  journal       = "Ocean Dynamics",
+  volume        = "60",
+  number        = "5",
+  author        = "F. Qiao and Y. Yuan and T. Ezer and C. Xia and 
+                   Y. Yang and X. Lu and Z. Song ",
+  year          = "2010",
+  month         = "oct",
+  publisher     = "Springer-Verlag",
+  issn          = "1616-7341",
+  doi           = "10.1007/s10236-010-0326-y"
+}
+
+@article{         redi_JPO82,
+  title         = "Oceanic isopycnal mixing by coordinate rotation",
+  pages         = "1154--1158",
+  journal       = "Journal of Physical Oceanography",
+  volume        = "12",
+  number        = "10",
+  author        = "M. H. Redi",
+  year          = "1982",
+  month         = "oct",
+  publisher     = "American Meteorological Society",
+  issn          = "1520-0485",
+  doi           = "10.1175/1520-0485(1982)012<1154:oimbcr>2.0.co;2"
+}
+
+@article{         reffray.guillaume.ea_GMD15,
+  title         = "Modelling turbulent vertical mixing sensitivity using
+                   a 1-D version of NEMO",
+  pages         = "69--86",
+  journal       = "Geoscientific Model Development",
+  volume        = "8",
+  number        = "1",
+  author        = "G. Reffray. and R. Bourdalle-Badie and C. Calone",
+  year          = "2015",
+  month         = "jan",
+  publisher     = "Copernicus GmbH",
+  issn          = "1991-9603",
+  doi           = "10.5194/gmd-8-69-2015"
+}
+
+@book{            richtmyer.morton_bk67,
+  pages         = "405",
+  booktitle     = "Difference methods for initial-value problems",
+  edition       = "2",
+  series        = "Interscience tracts in pure and applied mathematics",
+  author        = "R. D. Richtmyer and K. W. Morton",
+  year          = "1967",
+  publisher     = "Interscience",
+  issn          = "0074-994X",
+  isbn          = "9780470720400",
+  url           = "https://books.google.fr/books?id=nd1QAAAAMAAJ"
+}
+
+@article{         robert_JMSJ66,
+  title         = "The integration of a low order spectral form of the
+                  primitive meteorological equations",
+  pages         = "237--245",
+  journal       = "Journal of the Meteorological Society of Japan",
+  volume        = "44",
+  number        = "5",
+  author        = "A. J. Robert",
+  year          = "1966",
+  publisher     = "Meteorological Society of Japan",
+  issn          = "2186-9057",
+  doi           = "10.2151/jmsj1965.44.5\_237"
+}
+
+@article{         rodgers.aumont.ea_B14,
+  title         = "Strong sensitivity of Southern Ocean carbon uptake and
+                  nutrient cycling to wind stirring",
+  pages         = "4077--4098",
+  journal       = "Biogeosciences",
+  volume        = "11",
+  number        = "15",
+  author        = "K. B. Rodgers and O. Aumont and S. E. Mikaloff Fletcher
+                  and Y. Plancherel and L. Bopp and C. {de Boyer
+                  Mont\'{e}gut} and D. Iudicone and R. F. Keeling and G.
+                  Madec and R. Wanninkhof",
+  year          = "2014",
+  month         = "aug",
+  publisher     = "Copernicus GmbH",
+  issn          = "1726-4189",
+  doi           = "10.5194/bg-11-4077-2014"
+}
+
+@article{         rodi_JGR87,
+  title         = "Examples of calculation methods for flow and mixing in
+                  stratified fluids",
+  pages         = "5305--5328",
+  journal       = "Journal of Geophysical Research",
+  volume        = "92",
+  number        = "C5",
+  author        = "W. Rodi",
+  year          = "1987",
+  publisher     = "American Geophysical Union (AGU)",
+  issn          = "0148-0227",
+  doi           = "10.1029/jc092ic05p05305"
+}
+
+@article{         roquet.madec.ea_JPO15,
+  title         = "Defining a simplified yet ``realistic'' equation of state
+                  for seawater",
+  pages         = "2564--2579",
+  journal       = "Journal of Physical Oceanography",
+  volume        = "45",
+  number        = "10",
+  author        = "F. Roquet and G. Madec and L. Brodeau and J. Nycander",
+  year          = "2015",
+  month         = "oct",
+  publisher     = "American Meteorological Society",
+  issn          = "1520-0485",
+  doi           = "10.1175/jpo-d-15-0080.1"
+}
+
+@article{         roquet.madec.ea_OM15,
+  title         = "Accurate polynomial expressions for the density and
+                  specific volume of seawater using the {TEOS}-10 standard",
+  pages         = "29--43",
+  journal       = "Ocean Modelling",
+  volume        = "90",
+  author        = "F. Roquet and G. Madec and T. J. McDougall and P. M.
+                  Barker",
+  year          = "2015",
+  month         = "jun",
+  publisher     = "Elsevier BV",
+  issn          = "1463-5003",
+  doi           = "10.1016/j.ocemod.2015.04.002"
+}
+
+@article{         roullet.madec_JGR00,
+  title         = "Salt conservation, free surface, and varying levels: {A}
+                  new formulation for Ocean General Circulation Models",
+  pages         = "23927--23942",
+  journal       = "Journal of Geophysical Research",
+  volume        = "105",
+  number        = "C10",
+  author        = "G. Roullet and G. Madec",
+  year          = "2000",
+  month         = "oct",
+  publisher     = "American Geophysical Union (AGU)",
+  issn          = "0148-0227",
+  doi           = "10.1029/2000jc900089"
+}
+
+@article{         sarmiento.bryan_JGR82,
+  title         = "An ocean transport model for the North Atlantic",
+  pages         = "394--409",
+  journal       = "Journal of Geophysical Research",
+  volume        = "87",
+  number        = "C1",
+  author        = "J. L. Sarmiento and K. Bryan",
+  year          = "1982",
+  publisher     = "American Geophysical Union (AGU)",
+  issn          = "0148-0227",
+  doi           = "10.1029/jc087ic01p00394"
+}
+
+@article{         saunders_JAS67,
+  title         = "The temperature at the ocean-air interface",
+  pages         = "269--273",
+  journal       = "Journal of the Atmospheric Sciences",
+  volume        = "24",
+  number        = "3",
+  author        = "P. M. Saunders",
+  year          = "1967",
+  month         = "may",
+  publisher     = "American Meteorological Society",
+  issn          = "1520-0469",
+  doi           = "10.1175/1520-0469(1967)024<0269:ttatoa>2.0.co;2"
+}
+
+@article{         shchepetkin.mcwilliams_OM05,
+  title         = "The regional oceanic modeling system ({ROMS}): a
+                  split-explicit, free-surface,
+                  topography-following-coordinate oceanic model",
+  pages         = "347--404",
+  journal       = "Ocean Modelling",
+  volume        = "9",
+  number        = "4",
+  author        = "A. F. Shchepetkin and J. C. McWilliams",
+  year          = "2005",
+  month         = "jan",
+  publisher     = "Elsevier BV",
+  issn          = "1463-5003",
+  doi           = "10.1016/j.ocemod.2004.08.002"
+}
+
+@inbook{          shchepetkin.mcwilliams_ibk09,
+  title         = "Computational kernel algorithms for fine-scale,
+                  multiprocess, longtime oceanic simulations",
+  chapter       = "2",
+  pages         = "121--183",
+  booktitle     = "Computational Methods for the Atmosphere and the Oceans",
+  editor        = "R. M. Temam and J. J. Tribbia",
+  series        = "Handbook of Numerical Analysis",
+  volume        = "14",
+  author        = "A. F. Shchepetkin and J. C. McWilliams",
+  year          = "2009",
+  publisher     = "Elsevier",
+  issn          = "1570-8659",
+  isbn          = "9780444518934",
+  doi           = "10.1016/s1570-8659(08)01202-0"
+}
+
+@article{         shchepetkin_OM15,
+  title         = "An Adaptive, Courant-number-dependent implicit
+  		 scheme for vertical advection in oceanic modeling",
+  pages         = "38--69",
+  journal       = "Ocean Modelling",
+  volume        = "91",
+  author        = "A. F. Shchepetkin",
+  year          = "2015",
+  month         = "july",
+  publisher     = "Elsevier BV",
+  issn          = "1463-5003",
+  doi           = "10.1016/j.ocemod.2015.03.006"
+}
+
+@article{         siddorn.furner_OM13,
+  title         = "An analytical stretching function that combines the best
+                  attributes of geopotential and terrain-following vertical
+                  coordinates",
+  pages         = "1--13",
+  journal       = "Ocean Modelling",
+  volume        = "66",
+  author        = "J. R. Siddorn and R. Furner",
+  year          = "2013",
+  month         = "jun",
+  publisher     = "Elsevier BV",
+  issn          = "1463-5003",
+  doi           = "10.1016/j.ocemod.2013.02.001"
+}
+
+@article{         simmons.jayne.ea_OM04,
+  title         = "Tidally driven mixing in a numerical model of the ocean
+                  general circulation",
+  pages         = "245--263",
+  journal       = "Ocean Modelling",
+  volume        = "6",
+  number        = "3-4",
+  author        = "H. L. Simmons and S. R. Jayne and L. C. {St Laurent} and
+                  A. J. Weaver",
+  year          = "2004",
+  month         = "jan",
+  publisher     = "Elsevier BV",
+  issn          = "1463-5003",
+  doi           = "10.1016/s1463-5003(03)00011-8"
+}
+
+@article{         smagorinsky_MW63,
+  title         = "General circulation experiments with the primitive equations: I. The basic experiment ",
+  pages         = "99--164",
+  journal       = "Monthly Weather Review",
+  volume        = "91",
+  number        = "3",
+  author        = "J. Smagorinsky",
+  year          = "1963",
+  month         = "mar",
+  publisher     = "American Meteorological Society",
+  issn          = "1520-0493",
+  doi           = "10.1175/1520-0493(1963)091<0099:GCEWTP>2.3.CO;2"
+}
+
+@article{         song.haidvogel_JCP94,
+  title         = "A semi-implicit ocean circulation model using a
+                  generalized topography-following coordinate system",
+  pages         = "228--244",
+  journal       = "Journal of Computational Physics",
+  volume        = "115",
+  number        = "1",
+  author        = "Y. Song and D. Haidvogel",
+  year          = "1994",
+  month         = "nov",
+  publisher     = "Elsevier BV",
+  issn          = "0021-9991",
+  doi           = "10.1006/jcph.1994.1189"
+}
+
+@article{         song_MWR98,
+  title         = "A General Pressure Gradient Formulation for Ocean Models.
+                  Part {I}: Scheme Design and Diagnostic Analysis",
+  pages         = "3213--3230",
+  journal       = "Monthly Weather Review",
+  volume        = "126",
+  number        = "12",
+  author        = "Y. T. Song",
+  year          = "1998",
+  month         = "dec",
+  publisher     = "American Meteorological Society",
+  issn          = "1520-0493",
+  doi           = "10.1175/1520-0493(1998)126<3213:agpgff>2.0.co;2"
+}
+
+@article{         st-laurent.nash_DSR04,
+  title         = "An examination of the radiative and dissipative properties
+                  of deep ocean internal tides",
+  pages         = "3029--3042",
+  journal       = "Deep Sea Research",
+  volume        = "51",
+  number        = "25-26",
+  author        = "L. C. {St Laurent} and J. D. Nash",
+  year          = "2004",
+  month         = "dec",
+  publisher     = "Elsevier BV",
+  issn          = "0967-0645",
+  doi           = "10.1016/j.dsr2.2004.09.008"
+}
+
+@article{         st-laurent.simmons.ea_GRL02,
+  title         = "Estimating tidally driven mixing in the deep ocean",
+  pages         = "2101--2104",
+  journal       = "Geophysical Research Letters",
+  volume        = "29",
+  number        = "23",
+  author        = "L. C. {St Laurent} and H. L. Simmons and S. R. Jayne",
+  year          = "2002",
+  month         = "dec",
+  publisher     = "American Geophysical Union (AGU)",
+  issn          = "0094-8276",
+  doi           = "10.1029/2002gl015633"
+}
+
+@article{         stacey_JPO99,
+  title         = "Simulations of the wind-forced near-surface circulation in
+                  Knight Inlet: {A} parameterization of the roughness length",
+  pages         = "1363--1367",
+  journal       = "Journal of Physical Oceanography",
+  volume        = "29",
+  number        = "6",
+  author        = "M. W. Stacey",
+  year          = "1999",
+  month         = "jun",
+  publisher     = "American Meteorological Society",
+  issn          = "1520-0485",
+  doi           = "10.1175/1520-0485(1999)029<1363:sotwfn>2.0.co;2"
+}
+
+@article{         steele.morley.ea_JC01,
+  title         = "{PHC}: {A} global ocean hydrography with a high-quality
+                  Arctic Ocean",
+  pages         = "2079--2087",
+  journal       = "Journal of Climate",
+  volume        = "14",
+  number        = "9",
+  author        = "M. Steele and R. Morley and W. Ermold",
+  year          = "2001",
+  month         = "may",
+  publisher     = "American Meteorological Society",
+  issn          = "1520-0442",
+  doi           = "10.1175/1520-0442(2001)014<2079:pagohw>2.0.co;2"
+}
+
+@article{         stein.stein_N92,
+  title         = "A model for the global variation in oceanic depth and heat
+                  flow with lithospheric age",
+  pages         = "123--129",
+  journal       = "Nature",
+  volume        = "359",
+  number        = "6391",
+  author        = "C. A. Stein and S. Stein",
+  year          = "1992",
+  month         = "sep",
+  publisher     = "Springer Nature",
+  issn          = "1476-4687",
+  doi           = "10.1038/359123a0"
+}
+
+@inbook{          stokes_ibk09,
+  title         = "On the theory of oscillatory waves",
+  chapter       = "12",
+  pages         = "197--229",
+  booktitle     = "Mathematical and Physical Papers",
+  series        = "Cambridge Library Collection - Mathematics",
+  volume        = "1",
+  author        = "G. G. Stokes",
+  year          = "2009",
+  publisher     = "Cambridge University Press",
+  isbn          = "9780511702242",
+  doi           = "10.1017/cbo9780511702242.013"
+}
+
+@article{         takaya.bidlot.ea_JGR10,
+  title         = "Refinements to a prognostic scheme of skin sea surface
+                  temperature",
+  pages         = "C06009",
+  journal       = "Journal of Geophysical Research",
+  volume        = "115",
+  number        = "C6",
+  author        = "Y. Takaya and J-R. Bidlot and A. C. M. Beljaars and P. A.
+                  E. M. Janssen",
+  year          = "2010",
+  month         = "jun",
+  publisher     = "American Geophysical Union (AGU)",
+  issn          = "0148-0227",
+  doi           = "10.1029/2009jc005985"
+}
+
+@article{         talagrand_JAS72,
+  title         = "On the damping of high-frequency motions in
+                  four-dimensional assimilation of meteorological data",
+  pages         = "1571--1574",
+  journal       = "Journal of the Atmospheric Sciences",
+  volume        = "29",
+  number        = "8",
+  author        = "O. Talagrand",
+  year          = "1972",
+  month         = "nov",
+  publisher     = "American Meteorological Society",
+  issn          = "1520-0469",
+  doi           = "10.1175/1520-0469(1972)029<1571:otdohf>2.0.co;2"
+}
+
+@article{         treguier.dukowicz.ea_JGR96,
+  title         = "Properties of nonuniform grids used in ocean general
+                  circulation models",
+  pages         = "20877--20881",
+  journal       = "Journal of Geophysical Research",
+  volume        = "101",
+  number        = "C9",
+  author        = "A.-M. Tr\'{e}guier and J. K. Dukowicz and K. Bryan",
+  year          = "1996",
+  month         = "sep",
+  publisher     = "American Geophysical Union (AGU)",
+  issn          = "0148-0227",
+  doi           = "10.1029/96jc01753"
+}
+
+@article{         treguier.held.ea_JPO97,
+  title         = "Parameterization of Quasigeostrophic Eddies in Primitive
+                  Equation Ocean Models",
+  pages         = "567--580",
+  journal       = "Journal of Physical Oceanography",
+  volume        = "27",
+  number        = "4",
+  author        = "A. M. Tr\'{e}guier and I. M. Held and V. D. Larichev",
+  year          = "1997",
+  month         = "apr",
+  publisher     = "American Meteorological Society",
+  issn          = "1520-0485",
+  doi           = "10.1175/1520-0485(1997)027<0567:poqeip>2.0.co;2"
+}
+
+@article{         treguier_JGR92,
+  title         = "Kinetic energy analysis of an eddy resolving, primitive
+                  equation model of the North Atlantic",
+  pages         = "687--701",
+  journal       = "Journal of Geophysical Research",
+  volume        = "97",
+  number        = "C1",
+  author        = "A. M. Tr\'{e}guier",
+  year          = "1992",
+  publisher     = "American Geophysical Union (AGU)",
+  issn          = "0148-0227",
+  doi           = "10.1029/91jc02350"
+}
+
+@article{         tu.tsuang_GRL05,
+  title         = "Cool-skin simulation by a one-column ocean model",
+  pages         = "L22602",
+  journal       = "Geophysical Research Letters",
+  volume        = "32",
+  number        = "22",
+  author        = "C.-Y. Tu and B.-J. Tsuang",
+  year          = "2005",
+  month         = "nov",
+  publisher     = "American Geophysical Union (AGU)",
+  issn          = "0094-8276",
+  doi           = "10.1029/2005gl024252"
+}
+
+@article{         umlauf.burchard_CSR05,
+  title         = "Second-order turbulence closure models for geophysical
+                  boundary layers. {A} review of recent work",
+  pages         = "795--827",
+  journal       = "Continental Shelf Research",
+  volume        = "25",
+  number        = "7-8",
+  author        = "L. Umlauf and H. Burchard",
+  year          = "2005",
+  month         = "may",
+  publisher     = "Elsevier BV",
+  issn          = "0278-4343",
+  doi           = "10.1016/j.csr.2004.08.004"
+}
+
+@article{         umlauf.burchard_JMR03,
+  title         = "A generic length-scale equation for geophysical turbulence
+                  models",
+  pages         = "235--265",
+  journal       = "Journal of Marine Research",
+  volume        = "61",
+  number        = "2",
+  author        = "L. Umlauf and H. Burchard",
+  year          = "2003",
+  month         = "mar",
+  publisher     = "Journal of Marine Research/Yale",
+  issn          = "0022-2402",
+  doi           = "10.1357/002224003322005087"
+}
+
+@book{            vallis_bk06,
+  booktitle     = "Atmospheric and Oceanic Fluid Dynamics",
+  author        = "G. K. Vallis",
+  year          = "2006",
+  publisher     = "Cambridge University Press",
+  isbn          = "9780511790447",
+  doi           = "10.1017/cbo9780511790447"
+}
+
+@article{         vancoppenolle.fichefet.ea_OM09*a,
+  title         = "Simulating the mass balance and salinity of Arctic and
+                  Antarctic sea ice. 1. Model description and validation",
+  pages         = "33--53",
+  journal       = "Ocean Modelling",
+  volume        = "27",
+  number        = "1-2",
+  author        = "M. Vancoppenolle and T. Fichefet and H. Goosse and S.
+                  Bouillon and G. Madec and M. A. Morales Maqueda",
+  year          = "2009",
+  month         = "jan",
+  publisher     = "Elsevier BV",
+  issn          = "1463-5003",
+  doi           = "10.1016/j.ocemod.2008.10.005"
+}
+
+@article{         vancoppenolle.fichefet.ea_OM09*b,
+  title         = "Simulating the mass balance and salinity of Arctic and
+                  Antarctic sea ice. 2. Importance of sea ice salinity
+                  variations",
+  pages         = "54--69",
+  journal       = "Ocean Modelling",
+  volume        = "27",
+  number        = "1-2",
+  author        = "M. Vancoppenolle and T. Fichefet and H. Goosse",
+  year          = "2009",
+  month         = "jan",
+  publisher     = "Elsevier BV",
+  issn          = "1463-5003",
+  doi           = "10.1016/j.ocemod.2008.11.003"
+}
+
+@article{         warner.defne.ea_CG13,
+  title         = "A wetting and drying scheme for {ROMS}",
+  pages         = "54--61",
+  journal       = "Computers \& Geosciences",
+  volume        = "58",
+  author        = "J. C. Warner and Z. Defne and K. Haas and H. G. Arango",
+  year          = "2013",
+  month         = "aug",
+  publisher     = "Elsevier BV",
+  issn          = "0098-3004",
+  doi           = "10.1016/j.cageo.2013.05.004"
+}
+
+@article{         warner.sherwood.ea_OM05,
+  title         = "Performance of four turbulence closure models implemented
+                  using a generic length scale method",
+  pages         = "81--113",
+  journal       = "Ocean Modelling",
+  volume        = "8",
+  number        = "1-2",
+  author        = "J. C. Warner and C. R. Sherwood and H. G. Arango and R. P.
+                  Signell",
+  year          = "2005",
+  month         = "jan",
+  publisher     = "Elsevier BV",
+  issn          = "1463-5003",
+  doi           = "10.1016/j.ocemod.2003.12.003"
+}
+
+@article{         weatherly_JMR84,
+  title         = "An estimate of bottom frictional dissipation by Gulf
+                  Stream fluctuations",
+  pages         = "289--301",
+  journal       = "Journal of Marine Research",
+  volume        = "42",
+  number        = "2",
+  author        = "G. L. Weatherly",
+  year          = "1984",
+  month         = "may",
+  publisher     = "Journal of Marine Research/Yale",
+  issn          = "1543-9542",
+  doi           = "10.1357/002224084788502729"
+}
+
+@article{         weaver.eby_JPO97,
+  title         = "On the numerical implementation of advection schemes for
+                  use in conjuction with various mixing parameterizations in
+                  the {GFDL} ocean model",
+  pages         = "369--377",
+  journal       = "Journal of Physical Oceanography",
+  volume        = "27",
+  number        = "2",
+  author        = "A. J. Weaver and M. Eby",
+  year          = "1997",
+  month         = "feb",
+  publisher     = "American Meteorological Society",
+  issn          = "1520-0485",
+  doi           = "10.1175/1520-0485(1997)027<0369:otnioa>2.0.co;2"
+}
+
+@article{         webb.de-cuevas.ea_JAOT98,
+  title         = "Improved Advection Schemes for Ocean Models",
+  pages         = "1171--1187",
+  journal       = "Journal of Atmospheric and Oceanic Technology",
+  volume        = "15",
+  number        = "5",
+  author        = "D. J. Webb and B. A. {de Cuevas} and C. S. Richmond",
+  year          = "1998",
+  month         = "oct",
+  publisher     = "American Meteorological Society",
+  issn          = "1520-0426",
+  doi           = "10.1175/1520-0426(1998)015<1171:iasfom>2.0.co;2"
+}
+
+@article{         white.hoskins.ea_QJRMS05,
+  title         = "Consistent approximate models of the global atmosphere: shallow, deep,
+                  hydrostatic, quasi-hydrostatic and non-hydrostatic",
+  pages         = "2081--2107",
+  journal       = "Quarterly Journal of the Royal Meteorological Society",
+  volume        = "131",
+  author        = "A. A. White and B. J. Hoskins and I. Roulstone and A. Staniforth",
+  year          = "2005",
+  doi           = "10.1256/qj.04.49"
+}
+
+@article{         white.adcroft.ea_JCP09,
+  title         = "High-order regridding-remapping schemes for continuous
+                  isopycnal and generalized coordinates in ocean models",
+  pages         = "8665--8692",
+  journal       = "Journal of Computational Physics",
+  volume        = "228",
+  number        = "23",
+  author        = "L. White and A. Adcroft and R. Hallberg",
+  year          = "2009",
+  month         = "dec",
+  publisher     = "Elsevier BV",
+  issn          = "0021-9991",
+  doi           = "10.1016/j.jcp.2009.08.016"
+}
+
+@article{         wilcox_AJ88,
+  title         = "Reassessment of the scale-determining equation for
+                  advanced turbulence models",
+  pages         = "1299--1310",
+  journal       = "AIAA Journal",
+  volume        = "26",
+  number        = "11",
+  author        = "D. C. Wilcox",
+  year          = "1988",
+  month         = "nov",
+  publisher     = "American Institute of Aeronautics and Astronautics (AIAA)",
+  issn          = "1533-385X",
+  doi           = "10.2514/3.10041"
+}
+
+@article{         willebrand.barnier.ea_PO01,
+  title         = "Circulation characteristics in three eddy-permitting
+                  models of the North Atlantic",
+  pages         = "123--161",
+  journal       = "Progress in Oceanography",
+  volume        = "48",
+  number        = "2-3",
+  author        = "J. Willebrand and B. Barnier and C. B{\"{o}}ning and C.
+                  Dieterich and P. D. Killworth and C. Le Provost and Y. Jia
+                  and J.-M. Molines and A. L. New",
+  year          = "2001",
+  month         = "jan",
+  publisher     = "Elsevier BV",
+  issn          = "0079-6611",
+  doi           = "10.1016/s0079-6611(01)00003-9"
+}
+
+@article{         zalesak_JCP79,
+  title         = "Fully multidimensional flux-corrected transport algorithms
+                  for fluids",
+  pages         = "335--362",
+  journal       = "Journal of Computational Physics",
+  volume        = "31",
+  number        = "3",
+  author        = "S. T. Zalesak",
+  year          = "1979",
+  month         = "jun",
+  publisher     = "Elsevier BV",
+  issn          = "0021-9991",
+  doi           = "10.1016/0021-9991(79)90051-2"
+}
+
+@article{         zhang.endoh_JGR92,
+  title         = "A free surface General Circulation Model for the tropical
+                  Pacific Ocean",
+  pages         = "11237--11255",
+  journal       = "Journal of Geophysical Research",
+  volume        = "97",
+  number        = "C7",
+  author        = "R.-H. Zhang and M. Endoh",
+  year          = "1992",
+  publisher     = "American Geophysical Union (AGU)",
+  issn          = "0148-0227",
+  doi           = "10.1029/92jc00911"
+}
Index: NEMO/branches/2019/fix_vvl_ticket1791/doc/latex/NEMO/main/blocks.idx
===================================================================
--- NEMO/branches/2019/fix_vvl_ticket1791/doc/latex/NEMO/main/blocks.idx	(revision 11422)
+++ NEMO/branches/2019/fix_vvl_ticket1791/doc/latex/NEMO/main/blocks.idx	(revision 11422)
@@ -0,0 +1,1 @@
+link ../build/blocks.idx
Index: NEMO/branches/2019/fix_vvl_ticket1791/doc/latex/NEMO/main/chapters.tex
===================================================================
--- NEMO/branches/2019/fix_vvl_ticket1791/doc/latex/NEMO/main/chapters.tex	(revision 11422)
+++ NEMO/branches/2019/fix_vvl_ticket1791/doc/latex/NEMO/main/chapters.tex	(revision 11422)
@@ -0,0 +1,16 @@
+\subfile{../subfiles/introduction}        %% Introduction
+\subfile{../subfiles/chap_model_basics}
+\subfile{../subfiles/chap_time_domain}    %% Time discretisation (time stepping strategy)
+\subfile{../subfiles/chap_DOM}            %% Space discretisation
+\subfile{../subfiles/chap_TRA}            %% Tracer advection/diffusion equation
+\subfile{../subfiles/chap_DYN}            %% Dynamics : momentum equation
+\subfile{../subfiles/chap_SBC}            %% Surface Boundary Conditions
+\subfile{../subfiles/chap_LBC}            %% Lateral Boundary Conditions
+\subfile{../subfiles/chap_LDF}            %% Lateral diffusion
+\subfile{../subfiles/chap_ZDF}            %% Vertical diffusion
+\subfile{../subfiles/chap_DIA}            %% Outputs and Diagnostics
+\subfile{../subfiles/chap_OBS}            %% Observation operator
+\subfile{../subfiles/chap_ASM}            %% Assimilation increments
+\subfile{../subfiles/chap_STO}            %% Stochastic param.
+\subfile{../subfiles/chap_misc}           %% Miscellaneous topics
+\subfile{../subfiles/chap_CONFIG}         %% Predefined configurations
Index: NEMO/branches/2019/fix_vvl_ticket1791/doc/latex/NEMO/main/definitions.tex
===================================================================
--- NEMO/branches/2019/fix_vvl_ticket1791/doc/latex/NEMO/main/definitions.tex	(revision 11422)
+++ NEMO/branches/2019/fix_vvl_ticket1791/doc/latex/NEMO/main/definitions.tex	(revision 11422)
@@ -0,0 +1,15 @@
+%% Engine (folder name)
+\def \engine{NEMO}
+
+%% Title (variable name already use by 'titling' pkg)
+\def \heading{NEMO ocean engine}
+
+%% Authors (thanks will apply to the second author)
+\def \firstauthor{Gurvan Madec~}
+\def \secondauthor{NEMO System Team}
+
+%% IPSL publication number
+\def \ipslnum{27}
+
+%% Zenodo ID, i.e. doi:10.5281/zenodo.\([0-9]*\)
+\def \zid{1464816}
Index: NEMO/branches/2019/fix_vvl_ticket1791/doc/latex/NEMO/main/foreword.tex
===================================================================
--- NEMO/branches/2019/fix_vvl_ticket1791/doc/latex/NEMO/main/foreword.tex	(revision 11422)
+++ NEMO/branches/2019/fix_vvl_ticket1791/doc/latex/NEMO/main/foreword.tex	(revision 11422)
@@ -0,0 +1,22 @@
+% ================================================================
+% Foreword
+% ================================================================
+\chapter*{Foreword}
+
+The ocean engine of NEMO (Nucleus for European Modelling of the Ocean) is a primitive equation model adapted to
+regional and global ocean circulation problems.
+It is intended to be a flexible tool for studying the ocean and its interactions with the others components of
+the earth climate system over a wide range of space and time scales.
+
+Prognostic variables are the three-dimensional velocity field, a non-linear sea surface height,
+the \textit{Conservative} Temperature and the \textit{Absolute} Salinity.
+In the horizontal direction, the model uses a curvilinear orthogonal grid and in the vertical direction,
+a full or partial step $z$-coordinate, or $s$-coordinate, or a mixture of the two.
+The distribution of variables is a three-dimensional Arakawa C-type grid.
+Various physical choices are available to describe ocean physics, including TKE, and GLS vertical physics.
+
+Within NEMO, the ocean is interfaced with a sea-ice model (SI$^3$)
+ %or \href{https://github.com/CICE-Consortium/CICE}{CICE}),
+passive tracer and biogeochemical models (TOP-PISCES) and,
+via the \href{https://portal.enes.org/oasis}{OASIS} coupler, with several atmospheric general circulation models.
+It also support two-way grid embedding via the \href{http://agrif.imag.fr}{AGRIF} software.
Index: NEMO/branches/2019/fix_vvl_ticket1791/doc/latex/NEMO/main/keys.idx
===================================================================
--- NEMO/branches/2019/fix_vvl_ticket1791/doc/latex/NEMO/main/keys.idx	(revision 11422)
+++ NEMO/branches/2019/fix_vvl_ticket1791/doc/latex/NEMO/main/keys.idx	(revision 11422)
@@ -0,0 +1,1 @@
+link ../build/keys.idx
Index: NEMO/branches/2019/fix_vvl_ticket1791/doc/latex/NEMO/main/modules.idx
===================================================================
--- NEMO/branches/2019/fix_vvl_ticket1791/doc/latex/NEMO/main/modules.idx	(revision 11422)
+++ NEMO/branches/2019/fix_vvl_ticket1791/doc/latex/NEMO/main/modules.idx	(revision 11422)
@@ -0,0 +1,1 @@
+link ../build/modules.idx
Index: NEMO/branches/2019/fix_vvl_ticket1791/doc/latex/NEMO/main/parameters.idx
===================================================================
--- NEMO/branches/2019/fix_vvl_ticket1791/doc/latex/NEMO/main/parameters.idx	(revision 11422)
+++ NEMO/branches/2019/fix_vvl_ticket1791/doc/latex/NEMO/main/parameters.idx	(revision 11422)
@@ -0,0 +1,1 @@
+link ../build/parameters.idx
Index: NEMO/branches/2019/fix_vvl_ticket1791/doc/latex/NEMO/main/subroutines.idx
===================================================================
--- NEMO/branches/2019/fix_vvl_ticket1791/doc/latex/NEMO/main/subroutines.idx	(revision 11422)
+++ NEMO/branches/2019/fix_vvl_ticket1791/doc/latex/NEMO/main/subroutines.idx	(revision 11422)
@@ -0,0 +1,1 @@
+link ../build/subroutines.idx
Index: NEMO/branches/2019/fix_vvl_ticket1791/doc/latex/NEMO/main/thanks.tex
===================================================================
--- NEMO/branches/2019/fix_vvl_ticket1791/doc/latex/NEMO/main/thanks.tex	(revision 11422)
+++ NEMO/branches/2019/fix_vvl_ticket1791/doc/latex/NEMO/main/thanks.tex	(revision 11422)
@@ -0,0 +1,2 @@
+J\'{e}r\^{o}me Chanut,
+Silvia Mocavero
