Changeset 9393

branches/2017/dev_merge_2017/DOC/build_NEMO_manual.sh

-                      r9388
+                      r9393
 latex       ${latex_opts}           ${latex_file}
 makeindex   -s ${latex_file}.sty    ${latex_file}
+makeindex   -s ${latex_file}.ist    ${latex_file}
 bibtex                              ${latex_file}
+latex       ${latex_opts}           ${latex_file}
 pdflatex    ${latex_opts}           ${latex_file}

branches/2017/dev_merge_2017/DOC/clean.sh

r9388	r9393
1	1	#!/bin/bash
2	2
3		rm -f $( ls -1 tex_main/NEMO_* \| egrep -v "\.(bib\|sty\|tex)$" )
	3	rm -f $( ls -1 tex_main/NEMO_* \| egrep -v "\.(bib\|ist\|sty\|tex)$" )
4	4	#rm -rf _minted-*
5	5	#rm -rf html*

branches/2017/dev_merge_2017/DOC/tex_main/NEMO_manual.sty

-                      r9389
+                      r9393
 \newcommand{\NEMO}{\textit{NEMO}\xspace}
+\newcommand{\ifile}[1]{\textit{   #1.nc}\index{Input NetCDF files!#1.nc}}
+\newcommand{   \hf}[1]{\textit{  #1.h90}\index{             h90 file!#1}}
+\newcommand{  \key}[1]{\textbf{ key\_#1}\index{        CPP keys!key\_#1}}
+\newcommand{  \mdl}[1]{\textit{  #1.F90}\index{              Modules!#1}}
+\newcommand{  \ngn}[1]{\textit{      #1}\index{  Namelist Group Name!#1}}
+\newcommand{  \rou}[1]{\textit{      #1}\index{             Routines!#1}}
+\newcommand{\jp}[1]{\forcode{#1}\index{  Model parameters!#1}}
+\newcommand{\np}[1]{\forcode{#1}\index{Namelist variables!#1}}
+\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]{\textit{#1}\index{Model parameters!#1}}
+\newcommand{\key}[1]{\textbf{key\_#1}\index{CPP keys!key\_#1}}
+\newcommand{\mdl}[1]{\textit{#1.F90}\index{Modules!#1}}
+\newcommand{\ngn}[1]{\textit{#1}\index{Namelist Group Name!#1}}
+\newcommand{\np}[1]{\textit{#1}\index{Namelist variables!#1}}
+\newcommand{\rou}[1]{\textit{#1}\index{Routines!#1}}
 \newcommand{\grad}{\nabla}

branches/2017/dev_merge_2017/DOC/tex_main/NEMO_manual.tex

-                      r9389
+                      r9393
 %% Index
 %\addcontentsline{toc}{chapter}{Index}
+\addcontentsline{toc}{chapter}{Index}
 \printindex
 …
 %% Bibliography
+\addcontentsline{toc}{chapter}{Bibliography}
 \bibliography{../tex_main/NEMO_manual}

branches/2017/dev_merge_2017/DOC/tex_sub/abstract_foreword.tex

r9389	r9393
31	31	\chapter*{Disclaimer}
32	32
33		Like all components of NEMO, the ocean component is developed under the ~~CECILL license~~,
	33	Like all components of NEMO, the ocean component is developed under the \href{http://www.cecill.info/}{CECILL license},
34	34	which is a French adaptation of the GNU GPL (General Public License). Anyone may use it
35	35	freely for research purposes, and is encouraged to communicate back to the NEMO team

branches/2017/dev_merge_2017/DOC/tex_sub/annex_A.tex

-                      r9389
+                      r9393
 % Chain rule
 % ================================================================
 \section{The chain rule for $s-$coordinates}
+\section{Chain rule for $s-$coordinates}
 \label{Apdx_A_continuity}
 …
 % continuity equation
 % ================================================================
 \section{Continuity Equation in $s-$coordinates}
+\section{Continuity equation in $s-$coordinates}
 \label{Apdx_A_continuity}
 …
 % momentum equation
 % ================================================================
 \section{Momentum Equation in $s-$coordinate}
+\section{Momentum equation in $s-$coordinate}
 \label{Apdx_A_momentum}
 …
 % Tracer equation
 % ================================================================
 \section{Tracer Equation}
+\section{Tracer equation}
 \label{Apdx_A_tracer}

branches/2017/dev_merge_2017/DOC/tex_sub/annex_B.tex

-                      r9389
+                      r9393
 % Horizontal/Vertical 2nd Order Tracer Diffusive Operators
 % ================================================================
 \section{Horizontal/Vertical 2nd Order Tracer Diffusive Operators}
+\section{Horizontal/Vertical $2^{nd}$ order tracer diffusive operators}
 \label{Apdx_B_1}
 …
 % Isopycnal/Vertical 2nd Order Tracer Diffusive Operators
 % ================================================================
 \section{Iso/diapycnal 2nd Order Tracer Diffusive Operators}
+\section{Iso/Diapycnal $2^{nd}$ order tracer diffusive operators}
 \label{Apdx_B_2}
 …
 % Lateral/Vertical Momentum Diffusive Operators
 % ================================================================
 \section{Lateral/Vertical Momentum Diffusive Operators}
+\section{Lateral/Vertical momentum diffusive operators}
 \label{Apdx_B_3}

branches/2017/dev_merge_2017/DOC/tex_sub/annex_C.tex

-                      r9392
+                      r9393
 % Discrete Total energy Conservation : vector invariant form
 % ================================================================
 \section{Discrete total energy conservation : vector invariant form}
+\section{Discrete total energy conservation: vector invariant form}
 \label{Apdx_C.1}
 …
 %       Vorticity Term with ENE scheme
 % -------------------------------------------------------------------------------------------------------------
 \subsubsection{Vorticity Term with ENE scheme (\protect\np{ln_dynvor_ene}=.true.)}
+\subsubsection{Vorticity term with ENE scheme (\protect\np{ln\_dynvor\_ene}\forcode{ = .true.})}
 \label{Apdx_C_vorENE}
 …
 %       Vorticity Term with EEN scheme
 % -------------------------------------------------------------------------------------------------------------
 \subsubsection{Vorticity Term with EEN scheme (\protect\np{ln_dynvor_een}=.true.)}
+\subsubsection{Vorticity term with EEN scheme (\protect\np{ln\_dynvor\_een}\forcode{ = .true.})}
 \label{Apdx_C_vorEEN}
 …
 %       Gradient of Kinetic Energy / Vertical Advection
 % -------------------------------------------------------------------------------------------------------------
 \subsubsection{Gradient of Kinetic Energy / Vertical Advection}
+\subsubsection{Gradient of kinetic energy / Vertical advection}
 \label{Apdx_C_zad}
 …
 %       Pressure Gradient Term
 % -------------------------------------------------------------------------------------------------------------
 \subsection{Pressure Gradient Term}
+\subsection{Pressure gradient term}
 \label{Apdx_C.1.4}
 …
 % Discrete Total energy Conservation : flux form
 % ================================================================
 \section{Discrete total energy conservation : flux form}
+\section{Discrete total energy conservation: flux form}
 \label{Apdx_C.1}
 …
 %       Coriolis plus ``metric'' Term
 % -------------------------------------------------------------------------------------------------------------
 \subsubsection{Coriolis plus ``metric'' Term}
+\subsubsection{Coriolis plus ``metric'' term}
 \label{Apdx_C.1.3.1}
 …
 %       Vorticity Term with ENS scheme
 % -------------------------------------------------------------------------------------------------------------
 \subsubsection{Vorticity Term with ENS scheme  (\protect\np{ln_dynvor_ens}=.true.)}
+\subsubsection{Vorticity term with ENS scheme  (\protect\np{ln\_dynvor\_ens}\forcode{ = .true.})}
 \label{Apdx_C_vorENS}
 …
 %       Vorticity Term with EEN scheme
 % -------------------------------------------------------------------------------------------------------------
 \subsubsection{Vorticity Term with EEN scheme (\protect\np{ln_dynvor_een}=.true.)}
+\subsubsection{Vorticity Term with EEN scheme (\protect\np{ln\_dynvor\_een}\forcode{ = .true.})}
 \label{Apdx_C_vorEEN}
 …
 % Conservation Properties on Tracers
 % ================================================================
 \section{Conservation Properties on Tracers}
+\section{Conservation properties on tracers}
 \label{Apdx_C.2}
 …
 %       Advection Term
 % -------------------------------------------------------------------------------------------------------------
 \subsection{Advection Term}
+\subsection{Advection term}
 \label{Apdx_C.2.1}
 …
 % Conservation Properties on Lateral Momentum Physics
 % ================================================================
 \section{Conservation Properties on Lateral Momentum Physics}
+\section{Conservation properties on lateral momentum physics}
 \label{Apdx_dynldf_properties}
 …
 %       Conservation of Potential Vorticity
 % -------------------------------------------------------------------------------------------------------------
 \subsection{Conservation of Potential Vorticity}
+\subsection{Conservation of potential vorticity}
 \label{Apdx_C.3.1}
 …
 %       Dissipation of Horizontal Kinetic Energy
 % -------------------------------------------------------------------------------------------------------------
 \subsection{Dissipation of Horizontal Kinetic Energy}
+\subsection{Dissipation of horizontal kinetic energy}
 \label{Apdx_C.3.2}
 …
 %       Dissipation of Enstrophy
 % -------------------------------------------------------------------------------------------------------------
 \subsection{Dissipation of Enstrophy}
+\subsection{Dissipation of enstrophy}
 \label{Apdx_C.3.3}
 …
 %       Conservation of Horizontal Divergence
 % -------------------------------------------------------------------------------------------------------------
 \subsection{Conservation of Horizontal Divergence}
+\subsection{Conservation of horizontal divergence}
 \label{Apdx_C.3.4}
 …
 %       Dissipation of Horizontal Divergence Variance
 % -------------------------------------------------------------------------------------------------------------
 \subsection{Dissipation of Horizontal Divergence Variance}
+\subsection{Dissipation of horizontal divergence variance}
 \label{Apdx_C.3.5}
 …
 % Conservation Properties on Vertical Momentum Physics
 % ================================================================
 \section{Conservation Properties on Vertical Momentum Physics}
+\section{Conservation properties on vertical momentum physics}
 \label{Apdx_C_4}
 …
 % Conservation Properties on Tracer Physics
 % ================================================================
 \section{Conservation Properties on Tracer Physics}
+\section{Conservation properties on tracer physics}
 \label{Apdx_C.5}
 …
 %       Conservation of Tracers
 % -------------------------------------------------------------------------------------------------------------
 \subsection{Conservation of Tracers}
+\subsection{Conservation of tracers}
 \label{Apdx_C.5.1}
 …
 %       Dissipation of Tracer Variance
 % -------------------------------------------------------------------------------------------------------------
 \subsection{Dissipation of Tracer Variance}
+\subsection{Dissipation of tracer variance}
 \label{Apdx_C.5.2}

branches/2017/dev_merge_2017/DOC/tex_sub/annex_D.tex

-                      r9389
+                      r9393
 % The program structure
 % ================================================================
 \section{The program structure}
+\section{Program structure}
 \label{Apdx_D_structure}
 …
 % Naming Conventions
 % ================================================================
 \section{Naming Conventions}
+\section{Naming conventions}
 \label{Apdx_D_naming}
 …
 % The program structure
 % ================================================================
 \section{The program structure}
 \label{Apdx_D_structure}
 To be done....
+%\section{Program structure}
+%label{Apdx_D_structure}
+%To be done....
 \end{document}

branches/2017/dev_merge_2017/DOC/tex_sub/annex_E.tex

-                      r9392
+                      r9393
 %        UBS scheme
 % -------------------------------------------------------------------------------------------------------------
 \section{Upstream Biased Scheme (UBS) (\protect\forcode{ln_traadv_ubs = .true.})}
+\section{Upstream Biased Scheme (UBS) (\protect\np{ln\_traadv\_ubs}\forcode{ = .true.})}
 \label{TRA_adv_ubs}
 …
 where the control of artificial diapycnal fluxes is of paramount importance.
 It has therefore been preferred to evaluate the vertical flux using the TVD
 scheme when \forcode{ln_traadv_ubs = .true.}.
+scheme when \np{ln\_traadv\_ubs}\forcode{ = .true.}.
 For stability reasons, in \eqref{Eq_tra_adv_ubs}, the first term which corresponds
 …
 %        Leap-Frog energetic
 % -------------------------------------------------------------------------------------------------------------
 \section{Leap-Frog energetic }
+\section{Leapfrog energetic}
 \label{LF}
 …
 % Griffies' iso-neutral diffusion operator :
 % ================================================================
 \subsection{Griffies' iso-neutral diffusion operator}
+\subsection{Griffies iso-neutral diffusion operator}
 Let try to define a scheme that get its inspiration from the \citet{Griffies_al_JPO98}
 …
 % Skew flux formulation for Eddy Induced Velocity :
 % ================================================================
 \subsection{ Eddy induced velocity and Skew flux formulation}
+\subsection{Eddy induced velocity and skew flux formulation}
 When Gent and McWilliams [1990] diffusion is used (\key{traldf\_eiv} defined),
 …
 % Discrete Invariants of the iso-neutral diffrusion
 % ================================================================
 \subsection{Discrete Invariants of the iso-neutral diffrusion}
+\subsection{Discrete invariants of the iso-neutral diffrusion}
 \label{Apdx_Gf_operator}
 …
 % Discrete Invariants of the skew flux formulation
 % ================================================================
 \subsection{Discrete Invariants of the skew flux formulation}
+\subsection{Discrete invariants of the skew flux formulation}
 \label{Apdx_eiv_skew}

branches/2017/dev_merge_2017/DOC/tex_sub/annex_iso.tex

-                      r9392
+                      r9393
 % Iso-neutral diffusion :
 % ================================================================
+\chapter[Iso-neutral diffusion and eddy advection using
+triads]{Iso-neutral diffusion and eddy advection using triads}
+\chapter{Iso-neutral diffusion and eddy advection using triads}
 \label{sec:triad}
 \minitoc
 …
 Two scheme are available to perform the iso-neutral diffusion.
 If the namelist logical \np{ln_traldf_triad} is set true,
+If the namelist logical \np{ln\_traldf\_triad} is set true,
 \NEMO updates both active and passive tracers using the Griffies triad representation
 of iso-neutral diffusion and the eddy-induced advective skew (GM) fluxes.
 If the namelist logical \np{ln_traldf_iso} is set true,
+If the namelist logical \np{ln\_traldf\_iso} is set true,
 the filtered version of Cox's original scheme (the Standard scheme) is employed (\S\ref{LDF_slp}).
 In the present implementation of the Griffies scheme,
 the advective skew fluxes are implemented even if \np{ln_traldf_eiv} is false.
+the advective skew fluxes are implemented even if \np{ln\_traldf\_eiv} is false.
 Values of iso-neutral diffusivity and GM coefficient are set as
 …
 The options specific to the Griffies scheme include:
 \begin{description}[font=\normalfont]
 \item[\np{ln_triad_iso}] See \S\ref{sec:triad:taper}. If this is set false (the default), then
+\item[\np{ln\_triad\_iso}] See \S\ref{sec:triad:taper}. If this is set false (the default), then
   `iso-neutral' mixing is accomplished within the surface mixed-layer
   along slopes linearly decreasing with depth from the value immediately below
   the mixed-layer to zero (flat) at the surface (\S\ref{sec:triad:lintaper}).
   This is the same treatment as used in the default implementation \S\ref{LDF_slp_iso}; Fig.~\ref{Fig_eiv_slp}.
   Where \np{ln_triad_iso} is set true, the vertical skew flux is further reduced
+  Where \np{ln\_triad\_iso} is set true, the vertical skew flux is further reduced
   to ensure no vertical buoyancy flux, giving an almost pure
   horizontal diffusive tracer flux within the mixed layer. This is similar to
   the tapering suggested by \citet{Gerdes1991}. See \S\ref{sec:triad:Gerdes-taper}
 \item[\np{ln_botmix_triad}] See \S\ref{sec:triad:iso_bdry}.
+\item[\np{ln\_botmix\_triad}] See \S\ref{sec:triad:iso_bdry}.
   If this is set false (the default) then the lateral diffusive fluxes
   associated with triads partly masked by topography are neglected.
   If it is set true, however, then these lateral diffusive fluxes are applied,
   giving smoother bottom tracer fields at the cost of introducing diapycnal mixing.
 \item[\np{rn_sw_triad}]  blah blah to be added....
+\item[\np{rn\_sw\_triad}]  blah blah to be added....
 \end{description}
 The options shared with the Standard scheme include:
 \begin{description}[font=\normalfont]
 \item[\np{ln_traldf_msc}]   blah blah to be added
 \item[\np{rn_slpmax}]  blah blah to be added
+\item[\np{ln\_traldf\_msc}]   blah blah to be added
+\item[\np{rn\_slpmax}]  blah blah to be added
 \end{description}
 \section{Triad formulation of iso-neutral diffusion}
 \label{sec:triad:iso}
 …
 but formulated within the \NEMO framework, using scale factors rather than grid-sizes.
 \subsection{The iso-neutral diffusion operator}
+\subsection{Iso-neutral diffusion operator}
 The iso-neutral second order tracer diffusive operator for small
 angles between iso-neutral surfaces and geopotentials is given by
 …
 $w$-points but involves horizontal gradients defined at $u$-points.
 \subsection{The standard discretization}
+\subsection{Standard discretization}
 The straightforward approach to discretize the lateral skew flux
 \eqref{eq:triad:i13c} from tracer cell $i,k$ to $i+1,k$, introduced in 1995
 …
 ($i.e.$ they enter the computation of density), but it does not work
 for a passive tracer.
 \subsection{Expression of the skew-flux in terms of triad slopes}
 \citep{Griffies_al_JPO98} introduce a different discretization of the
 …
 and in \eqref{eq:triad:i31} $a'_{1}={\:}_i^k{\mathbb{A}_w}_{1/2}^{1/2}$.
 \subsection{The full triad fluxes}
+\subsection{Full triad fluxes}
 A key property of iso-neutral diffusion is that it should not affect
 the (locally referenced) density. In particular there should be no
 …
   \end{pmatrix}.
 \end{flalign}
 \subsection{Ensuring the scheme does not increase tracer variance}
 \label{sec:triad:variance}
 …
 \right)
 \]
 \subsection{Triad volumes in Griffes's scheme and in \NEMO}
 To complete the discretization we now need only specify the triad
 …
 RHS of \eqref{eq:triad:iso_property3}.
 \end{description}
 \subsection{Treatment of the triads at the boundaries}\label{sec:triad:iso_bdry}
 The triad slope can only be defined where both the grid boxes centred at
 …
 or $i+1,k+1$ tracer points is masked, i.e.\ the $i,k+1$ $u$-point is
 masked. The associated lateral fluxes (grey-black dashed line) are
 masked if \forcode{ln_botmix_triad = .false.}, but left unmasked,
 giving bottom mixing, if \forcode{ln_botmix_triad = .true.}.
 The default option \forcode{ln_botmix_triad = .false.} is suitable when the
 bbl mixing option is enabled (\key{trabbl}, with \forcode{nn_bbl_ldf = 1}),
+masked if \np{ln\_botmix\_triad}\forcode{ = .false.}, but left unmasked,
+giving bottom mixing, if \np{ln\_botmix\_triad}\forcode{ = .true.}.
+The default option \np{ln\_botmix\_triad}\forcode{ = .false.} is suitable when the
+bbl mixing option is enabled (\key{trabbl}, with \np{nn\_bbl\_ldf}\forcode{ = 1}),
 or  for simple idealized  problems. For setups with topography without
 bbl mixing, \forcode{ln_botmix_triad = .true.} may be necessary.
+bbl mixing, \np{ln\_botmix\_triad}\forcode{ = .true.} may be necessary.
 % >>>>>>>>>>>>>>>>>>>>>>>>>>>>
 \begin{figure}[h] \begin{center}
 …
       or $i+1,k+1$ tracer points is masked, i.e.\ the $i,k+1$ $u$-point
       is masked. The associated lateral fluxes (grey-black dashed
       line) are masked if \protect\np{botmix_triad}=.false., but left
       unmasked, giving bottom mixing, if \protect\np{botmix_triad}=.true.}
+      line) are masked if \np{botmix\_triad}\forcode{ = .false.}, but left
+      unmasked, giving bottom mixing, if \np{botmix\_triad}\forcode{ = .true.}}
  \end{center} \end{figure}
 % >>>>>>>>>>>>>>>>>>>>>>>>>>>>
 \subsection{ Limiting of the slopes within the interior}\label{sec:triad:limit}
 As discussed in \S\ref{LDF_slp_iso}, iso-neutral slopes relative to
 …
 iso-neutral density flux that drives dianeutral mixing.  In particular this iso-neutral density flux
 is always downwards, and so acts to reduce gravitational potential energy.
 \subsection{Tapering within the surface mixed layer}\label{sec:triad:taper}
 Additional tapering of the iso-neutral fluxes is necessary within the
 surface mixed layer. When the Griffies triads are used, we offer two
 options for this.
 \subsubsection{Linear slope tapering within the surface mixed layer}\label{sec:triad:lintaper}
 This is the option activated by the default choice
 \forcode{ln_triad_iso = .false.}. Slopes $\tilde{r}_i$ relative to
+\np{ln\_triad\_iso}\forcode{ = .false.}. Slopes $\tilde{r}_i$ relative to
 geopotentials are tapered linearly from their value immediately below the mixed layer to zero at the
 surface, as described in option (c) of Fig.~\ref{Fig_eiv_slp}, to values
 …
 % >>>>>>>>>>>>>>>>>>>>>>>>>>>>
+\subsubsection{Additional truncation of skew iso-neutral flux
+  components}
+\subsubsection{Additional truncation of skew iso-neutral flux components}
 \label{sec:triad:Gerdes-taper}
 The alternative option is activated by setting \np{ln_triad_iso} =
+The alternative option is activated by setting \np{ln\_triad\_iso} =
   true. This retains the same tapered slope $\rML$  described above for the
 calculation of the $_{33}$ term of the iso-neutral diffusion tensor (the
 …
 \section{Eddy induced advection formulated as a skew flux}\label{sec:triad:skew-flux}
 \subsection{The continuous skew flux formulation}\label{sec:triad:continuous-skew-flux}
+\subsection{Continuous skew flux formulation}\label{sec:triad:continuous-skew-flux}
  When Gent and McWilliams's [1990] diffusion is used,
 …
 it to the Eulerian velocity prior to computing the tracer
 advection. This is implemented if \key{traldf\_eiv} is set in the
 default implementation, where \np{ln_traldf_triad} is set
+default implementation, where \np{ln\_traldf\_triad} is set
 false. This allows us to take advantage of all the advection schemes
 offered for the tracers (see \S\ref{TRA_adv}) and not just a $2^{nd}$
 …
 paramount importance.
 However, when \np{ln_traldf_triad} is set true, \NEMO instead
+However, when \np{ln\_traldf\_triad} is set true, \NEMO instead
 implements eddy induced advection according to the so-called skew form
 \citep{Griffies_JPO98}. It is based on a transformation of the advective fluxes
 …
  preserves the tracer variance.
 \subsection{The discrete skew flux formulation}
+\subsection{Discrete skew flux formulation}
 The skew fluxes in (\ref{eq:triad:eiv_skew_physical}, \ref{eq:triad:eiv_skew_ijk}), like the off-diagonal terms
 (\ref{eq:triad:i13c}, \ref{eq:triad:i31c}) of the small angle diffusion tensor, are best
 …
 operator as it uses the same definition for the slopes.  It also
 ensures the following two key properties.
 \subsubsection{No change in tracer variance}
 The discretization conserves tracer variance, $i.e.$ it does not
 …
 and $\triadt{i+1}{k}{R}{-1/2}{1/2}$ are masked when either of the
 $i,k+1$ or $i+1,k+1$ tracer points is masked, i.e.\ the $i,k+1$
 $u$-point is masked. The namelist parameter \np{ln_botmix_triad} has
+$u$-point is masked. The namelist parameter \np{ln\_botmix\_triad} has
 no effect on the eddy-induced skew-fluxes.
 \subsection{ Limiting of the slopes within the interior}\label{sec:triad:limitskew}
+\subsection{Limiting of the slopes within the interior}\label{sec:triad:limitskew}
 Presently, the iso-neutral slopes $\tilde{r}_i$ relative
 to geopotentials are limited to be less than $1/100$, exactly as in
 …
 option (c) of Fig.~\ref{Fig_eiv_slp}. This linear tapering for the
 slopes used to calculate the eddy-induced fluxes is
 unaffected by the value of \np{ln_triad_iso}.
+unaffected by the value of \np{ln\_triad\_iso}.
 The justification for this linear slope tapering is that, for $A_e$
 …
 \subsection{Streamfunction diagnostics}\label{sec:triad:sfdiag}
 Where the namelist parameter \forcode{ln_traldf_gdia = .true.}, diagnosed
+Where the namelist parameter \np{ln\_traldf\_gdia}\forcode{ = .true.}, diagnosed
 mean eddy-induced velocities are output. Each time step,
 streamfunctions are calculated in the $i$-$k$ and $j$-$k$ planes at

branches/2017/dev_merge_2017/DOC/tex_sub/chap_ASM.tex

-                      r9392
+                      r9393
 % Chapter Assimilation increments (ASM)
 % ================================================================
 \chapter{Apply assimilation increments (ASM)}
+\chapter{Apply Assimilation Increments (ASM)}
 \label{ASM}
 …
 Direct initialization (DI) refers to the instantaneous correction
 of the model background state using the analysis increment.
 DI is used when \np{ln_asmdin} is set to true.
+DI is used when \np{ln\_asmdin} is set to true.
 \section{Incremental Analysis Updates}
+\section{Incremental analysis updates}
 \label{ASM_IAU}
 …
 is referred to as Incremental Analysis Updates (IAU) \citep{Bloom_al_MWR96}.
 IAU is a common technique used with 3D assimilation methods such as 3D-Var or OI.
 IAU is used when \np{ln_asmiau} is set to true.
+IAU is used when \np{ln\_asmiau} is set to true.
 With IAU, the model state trajectory ${\bf x}$ in the assimilation window
 …
 integration \citep{Talagrand_JAS72, Dobricic_al_OS07}. Diffusion coefficients are defined as
 $A_D = \alpha e_{1t} e_{2t}$, where $\alpha = 0.2$. The divergence damping is activated by
 assigning to \np{nn_divdmp} in the \textit{nam\_asminc} namelist a value greater than zero.
+assigning to \np{nn\_divdmp} in the \textit{nam\_asminc} namelist a value greater than zero.
 By choosing this value to be of the order of 100 the increments in the vertical velocity will
 be significantly reduced.

branches/2017/dev_merge_2017/DOC/tex_sub/chap_CONFIG.tex

-                      r9392
+                      r9393
 % 1D model configuration
 % ================================================================
 \section{Water column model: 1D model (C1D) (\protect\key{c1d}) }
+\section{C1D: 1D Water column model (\protect\key{c1d}) }
 \label{CFG_c1d}
 …
 % ORCA family configurations
 % ================================================================
 \section{ORCA family: global ocean with tripolar grid }
+\section{ORCA family: global ocean with tripolar grid}
 \label{CFG_orca}
 …
 \begin{table}[!t]     \begin{center}
 \begin{tabular}{p{4cm} c c c c}
 Horizontal Grid                         & \np{ORCA_index} &  \np{jpiglo} & \np{jpjglo} &       \\
+Horizontal Grid                         & \np{ORCA\_index} &  \np{jpiglo} & \np{jpjglo} &       \\
 \hline  \hline
 \~4\deg     &        4         &         92     &      76      &       \\
 …
 uniformly applied to the whole domain.
 The GYRE configuration is set like an analytical configuration. Through \np{ln\_read\_cfg\textit{=false}} in \textit{namcfg} namelist defined in the reference configuration \textit{CONFIG/GYRE/EXP00/namelist\_cfg} anaylitical definition of grid in GYRE is done in usrdef\_hrg, usrdef\_zgr routines. Its horizontal resolution
 (and thus the size of the domain) is determined by setting \np{nn_GYRE} in  \ngn{namusr\_def}: \\
 \np{jpiglo} $= 30 \times$ \np{nn_GYRE} + 2   \\
 \np{jpjglo} $= 20 \times$ \np{nn_GYRE} + 2   \\
+The GYRE configuration is set like an analytical configuration. Through \np{ln\_read\_cfg}\forcode{ = .false.} in \textit{namcfg} namelist defined in the reference configuration \path{CONFIG/GYRE/EXP00/namelist_cfg} anaylitical definition of grid in GYRE is done in usrdef\_hrg, usrdef\_zgr routines. Its horizontal resolution
+(and thus the size of the domain) is determined by setting \np{nn\_GYRE} in  \ngn{namusr\_def}: \\
+\np{jpiglo} $= 30 \times$ \np{nn\_GYRE} + 2   \\
+\np{jpjglo} $= 20 \times$ \np{nn\_GYRE} + 2   \\
 Obviously, the namelist parameters have to be adjusted to the chosen resolution, see the Configurations
 pages on the NEMO web site (Using NEMO\/Configurations) .
 In the vertical, GYRE uses the default 30 ocean levels (\jp{jpk}=31) (Fig.~\ref{Fig_zgr}).
+In the vertical, GYRE uses the default 30 ocean levels (\jp{jpk}\forcode{ = 31}) (Fig.~\ref{Fig_zgr}).
 The GYRE configuration is also used in benchmark test as it is very simple to increase
 its resolution and as it does not requires any input file. For example, keeping a same model size
 on each processor while increasing the number of processor used is very easy, even though the
 physical integrity of the solution can be compromised. Benchmark is activate via \np{ln\_bench\textit{=true}} in \ngn{namusr\_def} in namelist  \textit{CONFIG/GYRE/EXP00/namelist\_cfg}.
+physical integrity of the solution can be compromised. Benchmark is activate via \np{ln\_bench}\forcode{ = .true.} in \ngn{namusr\_def} in namelist \path{CONFIG/GYRE/EXP00/namelist_cfg}.
 %>>>>>>>>>>>>>>>>>>>>>>>>>>>>
 …
 %       AMM configuration
 % -------------------------------------------------------------------------------------------------------------
 \section{AMM: atlantic margin configuration }
+\section{AMM: atlantic margin configuration}
 \label{MISC_config_AMM}
 …
 In addition to the tidal boundary condition the model may also take
 open boundary conditions from a North Atlantic model. Boundaries may be
 completely omitted by setting \np{ln_bdy} to false.
+completely omitted by setting \np{ln\_bdy} to false.
 Sample surface fluxes, river forcing and a sample initial restart file
 are included to test a realistic model run. The Baltic boundary is

branches/2017/dev_merge_2017/DOC/tex_sub/chap_DIA.tex

-                      r9392
+                      r9393
 %       Old Model Output
 % ================================================================
 \section{Old Model Output (default)}
+\section{Old model output (default)}
 \label{DIA_io_old}
 …
 % Diagnostics
 % ================================================================
 \section{Standard model Output (IOM)}
+\section{Standard model output (IOM)}
 \label{DIA_iom}
 …
 even without a parallel-enabled NetCDF4 library, simply by employing only one dedicated I/O server.
 \subsection{XIOS: the IO\_SERVER}
+\subsection{XIOS: XML Inputs-Outputs Server}
 \subsubsection{Attached or detached mode?}
 …
 \texttt{ mpirun -np 62 ./nemo.exe : -np 2 ./xios\_server.exe }
 \subsubsection{Control of XIOS: the XIOS context in iodef.xml}
+\subsubsection{Control of XIOS: the context in iodef.xml}
 As well as the {\tt using\_server} flag, other controls on the use of XIOS are set in the XIOS context in iodef.xml.
 …
 you used in the f90 code (see subsequent sections for a details of the XML syntax and rules).
 For example:
-\vspace{-20pt}
 \begin{xmllines}
    <field_definition>
 …
 and axes either defined in the code (iom\_set\_domain\_attr and iom\_set\_axis\_attr in iom.F90)
 or defined in the domain\_def.xml file. $e.g.$:
-\vspace{-20pt}
 \begin{xmllines}
      <grid id="grid_T_3D" domain_ref="grid_T" axis_ref="deptht"/>
 \end{xmllines}
 Note, if your array is computed within the surface module each nn\_fsbc time\_step,
+Note, if your array is computed within the surface module each \np{nn\_fsbc} time\_step,
 add the field definition within the field\_group defined with the id ''SBC'': $<$field\_group id=''SBC''...$>$
 which has been defined with the correct frequency of operations (iom\_set\_field\_attr in iom.F90)
+\item[4.] add your field in one of the output files defined in iodef.xml (again see subsequent sections for syntax and rules)   \\
+\vspace{-20pt}
+\item[4.] add your field in one of the output files defined in iodef.xml (again see subsequent sections for syntax and rules)
 \begin{xmllines}
    <file id="file1" .../>
 …
 \end{description}
 \subsection{XML fundamentals}
 …
 See \href{http://www.xmlnews.org/docs/xml-basics.html}{here} for more details.
 \subsubsection{Structure of the xml file used in NEMO}
+\subsubsection{Structure of the XML file used in NEMO}
 The XML file used in XIOS is structured by 7 families of tags: context, axis, domain, grid, field, file and variable.
 …
 \\
 example 1: Direct inheritance.
-\vspace{-20pt}
 \begin{xmllines}
    <field_definition operation="average" >
 …
 \\
 example 2: Inheritance by reference.
-\vspace{-20pt}
 \begin{xmllines}
    <field_definition>
 …
 Inherit (and overwrite, if needed) the attributes of a tag you are refering to.
 \subsubsection{Use of Groups}
+\subsubsection{Use of groups}
 Groups can be used for 2 purposes.
 …
 In the following example, we define a group of field that will share a common grid ''grid\_T\_2D''.
 Note that for the field ''toce'', we overwrite the grid definition inherited from the group by ''grid\_T\_3D''.
-\vspace{-20pt}
 \begin{xmllines}
    <field_group id="grid_T" grid_ref="grid_T_2D">
 …
 Several examples of groups of fields are proposed at the end of the file {\tt CONFIG/SHARED/field\_def.xml}.
 For example, a short list of the usual variables related to the U grid:
-\vspace{-20pt}
 \begin{xmllines}
    <field_group id="groupU" >
 …
 \end{xmllines}
 that can be directly included in a file through the following syntax:
-\vspace{-20pt}
 \begin{xmllines}
    <file id="myfile_U" output_freq="1d" />
 …
 For example, in {\tt CONFIG/SHARED/domain\_def.xml}, we provide the following example of a definition
 of a 5 by 5 box with the bottom left corner at point (10,10).
-\vspace{-20pt}
 \begin{xmllines}
    <domain_group id="grid_T">
 …
 \end{xmllines}
 The use of this subdomain is done through the redefinition of the attribute domain\_ref of the tag family field. For example:
-\vspace{-20pt}
 \begin{xmllines}
    <file id="myfile_vzoom" output_freq="1d" >
 …
 for the equatorial sections and the mooring position for TAO, RAMA and PIRATA followed
 by ''T'' (for example: ''8s137eT'', ''1.5s80.5eT'' ...)
-\vspace{-20pt}
 \begin{xmllines}
    <file id="myfile_vzoom" output_freq="1d" >
 …
 \subsubsection{Define vertical zooms}
 Vertical zooms are defined through the attributs zoom\_begin and zoom\_end of the tag family axis. It must therefore be done in the axis part of the XML file. For example, in NEMOGCM/CONFIG/ORCA2\_LIM/iodef\_demo.xml, we provide the following example:
-\vspace{-20pt}
 \begin{xmllines}
    <axis_group id="deptht" long_name="Vertical T levels" unit="m" positive="down" >
 …
 \end{xmllines}
 The use of this vertical zoom is done through the redefinition of the attribute axis\_ref of the tag family field. For example:
-\vspace{-20pt}
 \begin{xmllines}
    <file id="myfile_hzoom" output_freq="1d" >
 …
 The output file names are defined by the attributs ''name'' and ''name\_suffix'' of the tag family file. for example:
-\vspace{-20pt}
 \begin{xmllines}
    <file_group id="1d" output_freq="1d" name="myfile_1d" >
 …
 }}
 \subsubsection{Other controls of the xml attributes from NEMO}
+\subsubsection{Other controls of the XML attributes from NEMO}
 The values of some attributes are defined by subroutine calls within NEMO (calls to iom\_set\_domain\_attr, iom\_set\_axis\_attr and iom\_set\_field\_attr in iom.F90). Any definition given in the xml file will be overwritten. By convention, these attributes are defined to ''auto'' (for string) or ''0000'' (for integer) in the xml file (but this is not necessary).
 …
    \hline
    \hline
     \multicolumn{2}{|c|}{field\_definition} & freq\_op & \np{rn_rdt} \\
    \hline
     \multicolumn{2}{|c|}{SBC}               & freq\_op & \np{rn_rdt} $\times$ \np{nn_fsbc}  \\
    \hline
     \multicolumn{2}{|c|}{ptrc\_T}           & freq\_op & \np{rn_rdt} $\times$ \np{nn_dttrc} \\
    \hline
     \multicolumn{2}{|c|}{diad\_T}           & freq\_op & \np{rn_rdt} $\times$ \np{nn_dttrc} \\
+    \multicolumn{2}{|c|}{field\_definition} & freq\_op & \np{rn\_rdt} \\
+   \hline
+    \multicolumn{2}{|c|}{SBC}               & freq\_op & \np{rn\_rdt} $\times$ \np{nn\_fsbc}  \\
+   \hline
+    \multicolumn{2}{|c|}{ptrc\_T}           & freq\_op & \np{rn\_rdt} $\times$ \np{nn\_dttrc} \\
+   \hline
+    \multicolumn{2}{|c|}{diad\_T}           & freq\_op & \np{rn\_rdt} $\times$ \np{nn\_dttrc} \\
    \hline
     \multicolumn{2}{|c|}{EqT, EqU, EqW} & jbegin, ni,      & according to the grid    \\
 …
 (1) Simple computation: directly define the computation when refering to the variable in the file definition.
+\vspace{-20pt}
+\begin{xmllines}
+ <field field\_ref="sst"  name="tosK"  unit="degK" > sst + 273.15 </field>
+ <field field\_ref="taum" name="taum2" unit="N2/m4" long\_name="square of wind stress module" > taum * taum </field>
+ <field field\_ref="qt"   name="stupid\_check" > qt - qsr - qns </field>
+\begin{xmllines}
+ <field field_ref="sst"  name="tosK"  unit="degK" > sst + 273.15 </field>
+ <field field_ref="taum" name="taum2" unit="N2/m4" long_name="square of wind stress module" > taum * taum </field>
+ <field field_ref="qt"   name="stupid_check" > qt - qsr - qns </field>
 \end{xmllines}
 …
 in field\_definition:
+\vspace{-20pt}
+\begin{xmllines}
+ <field id="sst2" long\_name="square of sea surface temperature" unit="degC2" >  sst * sst </field >
+\begin{xmllines}
+ <field id="sst2" long_name="square of sea surface temperature" unit="degC2" >  sst * sst </field >
 \end{xmllines}
 in file\_definition:
+\vspace{-20pt}
+\begin{xmllines}
+ <field field\_ref="sst2" > sst2 </field>
+\begin{xmllines}
+ <field field_ref="sst2" > sst2 </field>
 \end{xmllines}
 Note that in this case, the following syntaxe $<$field field\_ref="sst2" /$>$ is not working as sst2 won't be evaluated.
 …
 (3) Change of variable precision:
-\vspace{-20pt}
 \begin{xmllines}
      <!-- force to keep real 8 -->
  <field field\_ref="sst" name="tos\_r8" prec="8" />
       <!-- integer 2  with add\_offset and scale\_factor attributes -->
  <field field\_ref="sss" name="sos\_i2" prec="2" add\_offset="20." scale\_factor="1.e-3" />
+ <field field_ref="sst" name="tos_r8" prec="8" />
+      <!-- integer 2  with add_offset and scale_factor attributes -->
+ <field field_ref="sss" name="sos_i2" prec="2" add_offset="20." scale_factor="1.e-3" />
 \end{xmllines}
 Note that, then the code is crashing, writting real4 variables forces a numerical convection from real8 to real4 which will create an internal error in NetCDF and will avoid the creation of the output files. Forcing double precision outputs with prec="8" (for example in the field\_definition) will avoid this problem.
 …
 (4) add user defined attributes:
+\vspace{-20pt}
+\begin{xmllines}
+      <file\_group id="1d" output\_freq="1d" output\_level="10" enabled=".TRUE."> <!-- 1d files -->
+   <file id="file1" name\_suffix="\_grid\_T" description="ocean T grid variables" >
+     <field field\_ref="sst" name="tos" >
+       <variable id="my\_attribute1" type="string"  > blabla </variable>
+       <variable id="my\_attribute2" type="integer" > 3      </variable>
+       <variable id="my\_attribute3" type="float"   > 5.0    </variable>
+\begin{xmllines}
+      <file_group id="1d" output_freq="1d" output_level="10" enabled=".true."> <!-- 1d files -->
+   <file id="file1" name_suffix="_grid_T" description="ocean T grid variables" >
+     <field field_ref="sst" name="tos" >
+       <variable id="my_attribute1" type="string"  > blabla </variable>
+       <variable id="my_attribute2" type="integer" > 3      </variable>
+       <variable id="my_attribute3" type="float"   > 5.0    </variable>
      </field>
      <variable id="my\_global\_attribute" type="string" > blabla\_global </variable>
+     <variable id="my_global_attribute" type="string" > blabla_global </variable>
        </file>
      </file\_group>
+     </file_group>
 \end{xmllines}
 …
  - define a new variable in field\_definition
+\vspace{-20pt}
+\begin{xmllines}
+ <field id="toce\_e3t" long\_name="temperature * e3t" unit="degC*m" grid\_ref="grid\_T\_3D" > toce * e3t </field >
+\begin{xmllines}
+ <field id="toce_e3t" long_name="temperature * e3t" unit="degC*m" grid_ref="grid_T_3D" > toce * e3t </field >
 \end{xmllines}
  - use it when defining your file.
+\vspace{-20pt}
+\begin{xmllines}
+<file\_group id="5d" output\_freq="5d"  output\_level="10" enabled=".TRUE." >  <!-- 5d files -->
+ <file id="file1" name\_suffix="\_grid\_T" description="ocean T grid variables" >
+  <field field\_ref="toce" operation="instant" freq\_op="5d" > @toce\_e3t / @e3t </field>
+\begin{xmllines}
+<file_group id="5d" output_freq="5d"  output_level="10" enabled=".true." >  <!-- 5d files -->
+ <file id="file1" name_suffix="_grid_T" description="ocean T grid variables" >
+  <field field_ref="toce" operation="instant" freq_op="5d" > @toce_e3t / @e3t </field>
  </file>
 </file\_group>
+</file_group>
 \end{xmllines}
 The freq\_op="5d" attribute is used to define the operation frequency of the ``@'' function: here 5 day. The temporal operation done by the ``@'' is the one defined in the field definition: here we use the default, average. So, in the above case, @toce\_e3t will do the 5-day mean of toce*e3t. Operation="instant" refers to the temporal operation to be performed on the field''@toce\_e3t / @e3t'': here the temporal average is alreday done by the ``@'' function so we just use instant to do the ratio of the 2 mean values. field\_ref="toce" means that attributes not explicitely defined, are inherited from toce field. Note that in this case, freq\_op must be equal to the file output\_freq.
 …
  - define a new variable in field\_definition
+\vspace{-20pt}
+\begin{xmllines}
+ <field id="ssh2" long\_name="square of sea surface temperature" unit="degC2" >  ssh * ssh </field >
+\begin{xmllines}
+ <field id="ssh2" long_name="square of sea surface temperature" unit="degC2" >  ssh * ssh </field >
 \end{xmllines}
  - use it when defining your file.
+\vspace{-20pt}
+\begin{xmllines}
+<file\_group id="1m" output\_freq="1m"  output\_level="10" enabled=".TRUE." >  <!-- 1m files -->
+ <file id="file1" name\_suffix="\_grid\_T" description="ocean T grid variables" >
+  <field field\_ref="ssh" name="sshstd" long\_name="sea\_surface\_temperature\_standard\_deviation" operation="instant" freq\_op="1m" > sqrt( @ssh2 - @ssh * @ssh ) </field>
+\begin{xmllines}
+<file_group id="1m" output_freq="1m"  output_level="10" enabled=".true." >  <!-- 1m files -->
+ <file id="file1" name_suffix="_grid_T" description="ocean T grid variables" >
+  <field field_ref="ssh" name="sshstd" long_name="sea_surface_temperature_standard_deviation" operation="instant" freq_op="1m" > sqrt( @ssh2 - @ssh * @ssh ) </field>
  </file>
 </file\_group>
+</file_group>
 \end{xmllines}
 The freq\_op="1m" attribute is used to define the operation frequency of the ``@'' function: here 1 month. The temporal operation done by the ``@'' is the one defined in the field definition: here we use the default, average. So, in the above case, @ssh2 will do the monthly mean of ssh*ssh. Operation="instant" refers to the temporal operation to be performed on the field ''sqrt( @ssh2 - @ssh * @ssh )'': here the temporal average is alreday done by the ``@'' function so we just use instant. field\_ref="ssh" means that attributes not explicitely defined, are inherited from ssh field. Note that in this case, freq\_op must be equal to the file output\_freq.
 …
  - define 2 new variables in field\_definition
+\vspace{-20pt}
+\begin{xmllines}
+ <field id="sstmax" field\_ref="sst" long\_name="max of sea surface temperature" operation="maximum" />
+ <field id="sstmin" field\_ref="sst" long\_name="min of sea surface temperature" operation="minimum" />
+\begin{xmllines}
+ <field id="sstmax" field_ref="sst" long_name="max of sea surface temperature" operation="maximum" />
+ <field id="sstmin" field_ref="sst" long_name="min of sea surface temperature" operation="minimum" />
 \end{xmllines}
  - use these 2 new variables when defining your file.
+\vspace{-20pt}
+\begin{xmllines}
+<file\_group id="1m" output\_freq="1m"  output\_level="10" enabled=".TRUE." >  <!-- 1m files -->
+ <file id="file1" name\_suffix="\_grid\_T" description="ocean T grid variables" >
+  <field field\_ref="sst" name="sstdcy" long\_name="amplitude of sst diurnal cycle" operation="average" freq\_op="1d" > @sstmax - @sstmin </field>
+\begin{xmllines}
+<file_group id="1m" output_freq="1m"  output_level="10" enabled=".true." >  <!-- 1m files -->
+ <file id="file1" name_suffix="_grid_T" description="ocean T grid variables" >
+  <field field_ref="sst" name="sstdcy" long_name="amplitude of sst diurnal cycle" operation="average" freq_op="1d" > @sstmax - @sstmin </field>
  </file>
 </file\_group>
+</file_group>
 \end{xmllines}
 The freq\_op="1d" attribute is used to define the operation frequency of the ``@'' function: here 1 day. The temporal operation done by the ``@'' is the one defined in the field definition: here maximum for sstmax and minimum for sstmin. So, in the above case, @sstmax will do the daily max and @sstmin the daily min. Operation="average" refers to the temporal operation to be performed on the field ``@sstmax - @sstmin'': here monthly mean (of daily max - daily min of the sst). field\_ref="sst" means that attributes not explicitely defined, are inherited from sst field.
 …
    enabled &
    switch on/off the output of a field or a file &
    enabled=".TRUE." &
+   enabled=".true." &
    field, file families \\
    \hline
 …
 Output from the XIOS-1.0 IO server is compliant with \href{http://cfconventions.org/Data/cf-conventions/cf-conventions-1.5/build/cf-conventions.html}{version 1.5} of the CF metadata standard. Therefore while a user may wish to add their own metadata to the output files (as demonstrated in example 4 of section \ref{IOM_xmlref}) the metadata should, for the most part, comply with the CF-1.5 standard.
 Some metadata that may significantly increase the file size (horizontal cell areas and vertices) are controlled by the namelist parameter \np{ln_cfmeta} in the \ngn{namrun} namelist. This must be set to true if these metadata are to be included in the output files.
+Some metadata that may significantly increase the file size (horizontal cell areas and vertices) are controlled by the namelist parameter \np{ln\_cfmeta} in the \ngn{namrun} namelist. This must be set to true if these metadata are to be included in the output files.
 …
 %       NetCDF4 support
 % ================================================================
 \section{NetCDF4 Support (\protect\key{netcdf4})}
+\section{NetCDF4 support (\protect\key{netcdf4})}
 \label{DIA_iom}
 …
 new libraries and will then read both NetCDF3 and NetCDF4 files. NEMO
 executables linked with NetCDF4 libraries can be made to produce NetCDF3
 files by setting the \np{ln_nc4zip} logical to false in the \textit{namnc4}
+files by setting the \np{ln\_nc4zip} logical to false in the \textit{namnc4}
 namelist:
 …
 If \key{netcdf4} has not been defined, these namelist parameters are not read.
 In this case, \np{ln_nc4zip} is set false and dummy routines for a few
+In this case, \np{ln\_nc4zip} is set false and dummy routines for a few
 NetCDF4-specific functions are defined. These functions will not be used but
 need to be included so that compilation is possible with NetCDF3 libraries.
 …
 domain size in any dimension. The algorithm used is:
-\vspace{-20pt}
 \begin{forlines}
      ichunksz(1) = MIN( idomain_size,MAX( (idomain_size-1)/nn_nchunks_i + 1 ,16 ) )
 …
 \noindent As an example, setting:
-\vspace{-20pt}
 \begin{forlines}
      nn_nchunks_i=4, nn_nchunks_j=4 and nn_nchunks_k=31
 …
          &filesize & filesize & \% \\
          &(KB)     & (KB)     & \\
 \ifile{ORCA2\_restart\_0000} & 16420 & 8860 & 47\%\\
 \ifile{ORCA2\_restart\_0001} & 16064 & 11456 & 29\%\\
 \ifile{ORCA2\_restart\_0002} & 16064 & 9744 & 40\%\\
 \ifile{ORCA2\_restart\_0003} & 16420 & 9404 & 43\%\\
 \ifile{ORCA2\_restart\_0004} & 16200 & 5844 & 64\%\\
 \ifile{ORCA2\_restart\_0005} & 15848 & 8172 & 49\%\\
 \ifile{ORCA2\_restart\_0006} & 15848 & 8012 & 50\%\\
 \ifile{ORCA2\_restart\_0007} & 16200 & 5148 & 69\%\\
 \ifile{ORCA2\_2d\_grid\_T\_0000} & 2200 & 1504 & 32\%\\
 \ifile{ORCA2\_2d\_grid\_T\_0001} & 2200 & 1748 & 21\%\\
 \ifile{ORCA2\_2d\_grid\_T\_0002} & 2200 & 1592 & 28\%\\
 \ifile{ORCA2\_2d\_grid\_T\_0003} & 2200 & 1540 & 30\%\\
 \ifile{ORCA2\_2d\_grid\_T\_0004} & 2200 & 1204 & 46\%\\
 \ifile{ORCA2\_2d\_grid\_T\_0005} & 2200 & 1444 & 35\%\\
 \ifile{ORCA2\_2d\_grid\_T\_0006} & 2200 & 1428 & 36\%\\
 \ifile{ORCA2\_2d\_grid\_T\_0007} & 2200 & 1148 & 48\%\\
             ...         & ...  &  ... & ...  \\
 \ifile{ORCA2\_2d\_grid\_W\_0000} & 4416 & 2240 & 50\%\\
 \ifile{ORCA2\_2d\_grid\_W\_0001} & 4416 & 2924 & 34\%\\
 \ifile{ORCA2\_2d\_grid\_W\_0002} & 4416 & 2512 & 44\%\\
 \ifile{ORCA2\_2d\_grid\_W\_0003} & 4416 & 2368 & 47\%\\
 \ifile{ORCA2\_2d\_grid\_W\_0004} & 4416 & 1432 & 68\%\\
 \ifile{ORCA2\_2d\_grid\_W\_0005} & 4416 & 1972 & 56\%\\
 \ifile{ORCA2\_2d\_grid\_W\_0006} & 4416 & 2028 & 55\%\\
 \ifile{ORCA2\_2d\_grid\_W\_0007} & 4416 & 1368 & 70\%\\
+ORCA2\_restart\_0000.nc & 16420 & 8860 & 47\%\\
+ORCA2\_restart\_0001.nc & 16064 & 11456 & 29\%\\
+ORCA2\_restart\_0002.nc & 16064 & 9744 & 40\%\\
+ORCA2\_restart\_0003.nc & 16420 & 9404 & 43\%\\
+ORCA2\_restart\_0004.nc & 16200 & 5844 & 64\%\\
+ORCA2\_restart\_0005.nc & 15848 & 8172 & 49\%\\
+ORCA2\_restart\_0006.nc & 15848 & 8012 & 50\%\\
+ORCA2\_restart\_0007.nc & 16200 & 5148 & 69\%\\
+ORCA2\_2d\_grid\_T\_0000.nc & 2200 & 1504 & 32\%\\
+ORCA2\_2d\_grid\_T\_0001.nc & 2200 & 1748 & 21\%\\
+ORCA2\_2d\_grid\_T\_0002.nc & 2200 & 1592 & 28\%\\
+ORCA2\_2d\_grid\_T\_0003.nc & 2200 & 1540 & 30\%\\
+ORCA2\_2d\_grid\_T\_0004.nc & 2200 & 1204 & 46\%\\
+ORCA2\_2d\_grid\_T\_0005.nc & 2200 & 1444 & 35\%\\
+ORCA2\_2d\_grid\_T\_0006.nc & 2200 & 1428 & 36\%\\
+ORCA2\_2d\_grid\_T\_0007.nc & 2200 & 1148 & 48\%\\
+     ...         & ...  &  ... & ...  \\
+ORCA2\_2d\_grid\_W\_0000.nc & 4416 & 2240 & 50\%\\
+ORCA2\_2d\_grid\_W\_0001.nc & 4416 & 2924 & 34\%\\
+ORCA2\_2d\_grid\_W\_0002.nc & 4416 & 2512 & 44\%\\
+ORCA2\_2d\_grid\_W\_0003.nc & 4416 & 2368 & 47\%\\
+ORCA2\_2d\_grid\_W\_0004.nc & 4416 & 1432 & 68\%\\
+ORCA2\_2d\_grid\_W\_0005.nc & 4416 & 1972 & 56\%\\
+ORCA2\_2d\_grid\_W\_0006.nc & 4416 & 2028 & 55\%\\
+ORCA2\_2d\_grid\_W\_0007.nc & 4416 & 1368 & 70\%\\
 \end{tabular}
 \caption{   \protect\label{Tab_NC4}
 …
 When \key{iomput} is activated with \key{netcdf4} chunking and
 compression parameters for fields produced via \np{iom_put} calls are
+compression parameters for fields produced via \np{iom\_put} calls are
 set via an equivalent and identically named namelist to \textit{namnc4}
 in \np{xmlio\_server.def}. Typically this namelist serves the mean files
 …
 %       Tracer/Dynamics Trends
 % -------------------------------------------------------------------------------------------------------------
+\section[Tracer/Dynamics Trends (TRD)]
+                  {Tracer/Dynamics Trends  (\protect\ngn{namtrd})}
+\section{Tracer/Dynamics trends  (\protect\ngn{namtrd})}
 \label{DIA_trd}
 …
 Note that the output are done with xIOS, and therefore the \key{IOM} is required.
 What is done depends on the \ngn{namtrd} logical set to \textit{true}:
+What is done depends on the \ngn{namtrd} logical set to \forcode{.true.}:
 \begin{description}
 \item[\np{ln_glo_trd}] : at each \np{nn_trd} time-step a check of the basin averaged properties
+\item[\np{ln\_glo\_trd}] : at each \np{nn\_trd} time-step a check of the basin averaged properties
 of the momentum and tracer equations is performed. This also includes a check of $T^2$, $S^2$,
 $\tfrac{1}{2} (u^2+v2)$, and potential energy time evolution equations properties ;
 \item[\np{ln_dyn_trd}] : each 3D trend of the evolution of the two momentum components is output ;
 \item[\np{ln_dyn_mxl}] : each 3D trend of the evolution of the two momentum components averaged
+\item[\np{ln\_dyn\_trd}] : each 3D trend of the evolution of the two momentum components is output ;
+\item[\np{ln\_dyn\_mxl}] : each 3D trend of the evolution of the two momentum components averaged
                            over the mixed layer is output  ;
 \item[\np{ln_vor_trd}] : a vertical summation of the moment tendencies is performed,
+\item[\np{ln\_vor\_trd}] : a vertical summation of the moment tendencies is performed,
                            then the curl is computed to obtain the barotropic vorticity tendencies which are output ;
 \item[\np{ln_KE_trd}]  : each 3D trend of the Kinetic Energy equation is output ;
 \item[\np{ln_tra_trd}] : each 3D trend of the evolution of temperature and salinity is output ;
 \item[\np{ln_tra_mxl}] : each 2D trend of the evolution of temperature and salinity averaged
+\item[\np{ln\_KE\_trd}]  : each 3D trend of the Kinetic Energy equation is output ;
+\item[\np{ln\_tra\_trd}] : each 3D trend of the evolution of temperature and salinity is output ;
+\item[\np{ln\_tra\_mxl}] : each 2D trend of the evolution of temperature and salinity averaged
                            over the mixed layer is output ;
 \end{description}
 …
 \textbf{Note that} in the current version (v3.6), many changes has been introduced but not fully tested.
 In particular, options associated with \np{ln_dyn_mxl}, \np{ln_vor_trd}, and \np{ln_tra_mxl}
+In particular, options associated with \np{ln\_dyn\_mxl}, \np{ln\_vor\_trd}, and \np{ln\_tra\_mxl}
 are not working, and none of the option have been tested with variable volume ($i.e.$ \key{vvl} defined).
 …
 %       On-line Floats trajectories
 % -------------------------------------------------------------------------------------------------------------
 \section{On-line Floats trajectories (FLO) (\protect\key{floats})}
+\section{FLO: On-Line Floats trajectories (\protect\key{floats})}
 \label{FLO}
 %--------------------------------------------namflo-------------------------------------------------------
 …
 namelis variables. The algorithm used is based
 either on the work of \cite{Blanke_Raynaud_JPO97} (default option), or on a $4^th$
 Runge-Hutta algorithm (\forcode{ln_flork4 = .true.}). Note that the \cite{Blanke_Raynaud_JPO97}
+Runge-Hutta algorithm (\np{ln\_flork4}\forcode{ = .true.}). Note that the \cite{Blanke_Raynaud_JPO97}
 algorithm have the advantage of providing trajectories which are consistent with the
 numeric of the code, so that the trajectories never intercept the bathymetry.
 …
 \subsubsection{ Input data: initial coordinates }
 Initial coordinates can be given with Ariane Tools convention ( IJK coordinates ,(\forcode{ln_ariane = .true.}) )
+Initial coordinates can be given with Ariane Tools convention ( IJK coordinates ,(\np{ln\_ariane}\forcode{ = .true.}) )
 or with longitude and latitude.
 In case of Ariane convention, input filename is \np{init_float_ariane}. Its format is:
+In case of Ariane convention, input filename is \np{init\_float\_ariane}. Its format is:
 \texttt{ I J K nisobfl itrash itrash }
 …
 \np{jpnfl} is the total number of floats during the run.
 When initial positions are read in a restart file ( \np{ln_rstflo}= .TRUE. ),  \np{jpnflnewflo}
+When initial positions are read in a restart file (\np{ln\_rstflo}\forcode{ = .true.} ),  \np{jpnflnewflo}
 can be added in the initialization file.
 \subsubsection{ Output data }
 \np{nn_writefl} is the frequency of writing in float output file and \np{nn_stockfl}
+\subsubsection{Output data}
+\np{nn\_writefl} is the frequency of writing in float output file and \np{nn\_stockfl}
 is the frequency of creation of the float restart file.
 Output data can be written in ascii files (\np{ln_flo_ascii} = .TRUE. ). In that case,
+Output data can be written in ascii files (\np{ln\_flo\_ascii}\forcode{ = .true.}). In that case,
 output filename is trajec\_float.
 Another possiblity of writing format is Netcdf (\np{ln_flo_ascii} = .FALSE. ). There are 2 possibilities:
+Another possiblity of writing format is Netcdf (\np{ln\_flo\_ascii}\forcode{ = .false.}). There are 2 possibilities:
  - if (\key{iomput}) is used, outputs are selected in  iodef.xml. Here it is an example of specification
    to put in files description section:
+\vspace{-30pt}
+\begin{xmllines}
+     <group id="1d\_grid\_T" name="auto" description="ocean T grid variables" >   }
+\begin{xmllines}
+     <group id="1d_grid_T" name="auto" description="ocean T grid variables" >   }
        <file id="floats"  description="floats variables"> }\\
            <field ref="traj\_lon"   name="floats\_longitude"   freq\_op="86400" />}
            <field ref="traj\_lat"   name="floats\_latitude"    freq\_op="86400" />}
            <field ref="traj\_dep"   name="floats\_depth"       freq\_op="86400" />}
            <field ref="traj\_temp"  name="floats\_temperature" freq\_op="86400" />}
            <field ref="traj\_salt"  name="floats\_salinity"    freq\_op="86400" />}
            <field ref="traj\_dens"  name="floats\_density"     freq\_op="86400" />}
            <field ref="traj\_group" name="floats\_group"       freq\_op="86400" />}
+           <field ref="traj_lon"   name="floats_longitude"   freq_op="86400" />}
+           <field ref="traj_lat"   name="floats_latitude"    freq_op="86400" />}
+           <field ref="traj_dep"   name="floats_depth"       freq_op="86400" />}
+           <field ref="traj_temp"  name="floats_temperature" freq_op="86400" />}
+           <field ref="traj_salt"  name="floats_salinity"    freq_op="86400" />}
+           <field ref="traj_dens"  name="floats_density"     freq_op="86400" />}
+           <field ref="traj_group" name="floats_group"       freq_op="86400" />}
        </file>}
   </group>}
 …
 Some parameters are available in namelist \ngn{namdia\_harm} :
 - \np{nit000_han} is the first time step used for harmonic analysis
 - \np{nitend_han} is the last time step used for harmonic analysis
 - \np{nstep_han} is the time step frequency for harmonic analysis
 - \np{nb_ana} is the number of harmonics to analyse
+- \np{nit000\_han} is the first time step used for harmonic analysis
+- \np{nitend\_han} is the last time step used for harmonic analysis
+- \np{nstep\_han} is the time step frequency for harmonic analysis
+- \np{nb\_ana} is the number of harmonics to analyse
 - \np{tname} is an array with names of tidal constituents to analyse
 \np{nit000_han} and \np{nitend_han} must be between \np{nit000} and \np{nitend} of the simulation.
+\np{nit000\_han} and \np{nitend\_han} must be between \np{nit000} and \np{nitend} of the simulation.
 The restart capability is not implemented.
 …
 and the time scales over which they are averaged, as well as the level of output for debugging:
 \np{nn_dct}: frequency of instantaneous transports computing
 \np{nn_dctwri}: frequency of writing ( mean of instantaneous transports )
 \np{nn_debug}: debugging of the section
 \subsubsection{ Creating a binary file containing the pathway of each section }
+\np{nn\_dct}: frequency of instantaneous transports computing
+\np{nn\_dctwri}: frequency of writing ( mean of instantaneous transports )
+\np{nn\_debug}: debugging of the section
+\subsubsection{Creating a binary file containing the pathway of each section}
 In \texttt{NEMOGCM/TOOLS/SECTIONS\_DIADCT/run}, the file \textit{ {list\_sections.ascii\_global}}
 …
 \subsubsection{ To read the output files }
+\subsubsection{To read the output files}
 The output format is :
 …
 % Steric effect in sea surface height
 % ================================================================
 \section{Diagnosing the Steric effect in sea surface height}
+\section{Diagnosing the steric effect in sea surface height}
 \label{DIA_steric}
 …
 %       Other Diagnostics
 % -------------------------------------------------------------------------------------------------------------
 \section{Other Diagnostics (\protect\key{diahth}, \protect\key{diaar5})}
+\section{Other diagnostics (\protect\key{diahth}, \protect\key{diaar5})}
 \label{DIA_diag_others}
 …
 The poleward heat and salt transports, their advective and diffusive component, and
 the meriodional stream function can be computed on-line in \mdl{diaptr}
 \np{ln_diaptr} to true (see the \textit{\ngn{namptr} } namelist below).
 When \np{ln_subbas}~=~true, transports and stream function are computed
+\np{ln\_diaptr} to true (see the \textit{\ngn{namptr} } namelist below).
+When \np{ln\_subbas}\forcode{ = .true.}, transports and stream function are computed
 for the Atlantic, Indian, Pacific and Indo-Pacific Oceans (defined north of 30\deg S)
 as well as for the World Ocean. The sub-basin decomposition requires an input file
 …
 %       25 hour mean and hourly Surface, Mid and Bed
 % -----------------------------------------------------------
 \subsection{25 hour mean output for tidal models }
+\subsection{25 hour mean output for tidal models}
 %------------------------------------------nam_dia25h-------------------------------------
 …
 %     Top Middle and Bed hourly output
 % -----------------------------------------------------------
 \subsection{Top Middle and Bed hourly output }
+\subsection{Top middle and bed hourly output}
 %------------------------------------------nam_diatmb-----------------------------------------------------
 …
 in the zonal, meridional and vertical directions respectively. The vertical component is included although it is not strictly valid as the vertical velocity is calculated from the continuity equation rather than as a prognostic variable. Physically this represents the rate at which information is propogated across a grid cell. Values greater than 1 indicate that information is propagated across more than one grid cell in a single time step.
 The variables can be activated by setting the \np{nn_diacfl} namelist parameter to 1 in the \ngn{namctl} namelist. The diagnostics will be written out to an ascii file named cfl\_diagnostics.ascii. In this file the maximum value of $C_u$, $C_v$, and $C_w$ are printed at each timestep along with the coordinates of where the maximum value occurs. At the end of the model run the maximum value of $C_u$, $C_v$, and $C_w$ for the whole model run is printed along with the coordinates of each. The maximum values from the run are also copied to the ocean.output file.
+The variables can be activated by setting the \np{nn\_diacfl} namelist parameter to 1 in the \ngn{namctl} namelist. The diagnostics will be written out to an ascii file named cfl\_diagnostics.ascii. In this file the maximum value of $C_u$, $C_v$, and $C_w$ are printed at each timestep along with the coordinates of where the maximum value occurs. At the end of the model run the maximum value of $C_u$, $C_v$, and $C_w$ for the whole model run is printed along with the coordinates of each. The maximum values from the run are also copied to the ocean.output file.

branches/2017/dev_merge_2017/DOC/tex_sub/chap_DIU.tex

-                      r9392
+                      r9393
 % Edited by James While
 % ================================================================
 \chapter{Diurnal SST models (DIU)}
+\chapter{Diurnal SST Models (DIU)}
 \label{DIU}
 …
 This namelist contains only two variables:
 \begin{description}
 \item[\np{ln_diurnal}] A logical switch for turning on/off both the cool skin and warm layer.
 \item[\np{ln_diurnal_only}] A logical switch which if .TRUE. will run the diurnal model
+\item[\np{ln\_diurnal}] A logical switch for turning on/off both the cool skin and warm layer.
+\item[\np{ln\_diurnal\_only}] A logical switch which if \forcode{.true.} will run the diurnal model
 without the other dynamical parts of NEMO.
 \np{ln_diurnal_only} must be .FALSE. if \np{ln_diurnal} is .FALSE.
+\np{ln\_diurnal\_only} must be \forcode{.false.} if \np{ln\_diurnal} is \forcode{.false.}.
 \end{description}
 …
 %===============================================================
 \section{Warm Layer model}
+\section{Warm layer model}
 \label{warm_layer_sec}
 %===============================================================
 …
 %===============================================================
 \section{Cool Skin model}
+\section{Cool skin model}
 \label{cool_skin_sec}

branches/2017/dev_merge_2017/DOC/tex_sub/chap_DOM.tex

-                      r9392
+                      r9393
 % Chapter 2 ——— Space and Time Domain (DOM)
 % ================================================================
 \chapter{Space Domain (DOM) }
+\chapter{Space Domain (DOM)}
 \label{DOM}
 \minitoc
 …
 % Fundamentals of the Discretisation
 % ================================================================
 \section{Fundamentals of the Discretisation}
+\section{Fundamentals of the discretisation}
 \label{DOM_basics}
 …
 %        Arrangement of Variables
 % -------------------------------------------------------------------------------------------------------------
 \subsection{Arrangement of Variables}
+\subsection{Arrangement of variables}
 \label{DOM_cell}
 …
 %        Vector Invariant Formulation
 % -------------------------------------------------------------------------------------------------------------
 \subsection{Discrete Operators}
+\subsection{Discrete operators}
 \label{DOM_operators}
 …
 %        Numerical Indexing
 % -------------------------------------------------------------------------------------------------------------
 \subsection{Numerical Indexing}
+\subsection{Numerical indexing}
 \label{DOM_Num_Index}
 …
 %        Horizontal Indexing
 % -----------------------------------
 \subsubsection{Horizontal Indexing}
+\subsubsection{Horizontal indexing}
 \label{DOM_Num_Index_hor}
 …
 %        Vertical indexing
 % -----------------------------------
 \subsubsection{Vertical Indexing}
+\subsubsection{Vertical indexing}
 \label{DOM_Num_Index_vertical}
 …
 %        Domain Size
 % -----------------------------------
 \subsubsection{Domain Size}
+\subsubsection{Domain size}
 \label{DOM_size}
 …
 % Domain: List of fields needed
 % ================================================================
+\section  [Domain: Needed fields]
+      {Domain: Needed fields}
+\section{Needed fields}
 \label{DOM_fields}
 The ocean mesh ($i.e.$ the position of all the scalar and vector points) is defined
 …
 ie1e2u\_v is a flag to flag set u and  v surfaces are neither read nor computed.\\
 These fields can be read in an domain input file which name is setted in \np{cn_domcfg} parameter specified in \ngn{namcfg}.
+These fields can be read in an domain input file which name is setted in \np{cn\_domcfg} parameter specified in \ngn{namcfg}.
 \forfile{../namelists/namcfg}
 or they can be defined in an analytical way in MY\_SRC directory of the configuration.
 …
 % Domain: Horizontal Grid (mesh)
 % ================================================================
+\section  [Domain: Horizontal Grid (mesh) (\textit{domhgr})]
+      {Domain: Horizontal Grid (mesh) \small{(\protect\mdl{domhgr} module)} }
+\section{Horizontal grid mesh (\protect\mdl{domhgr})}
 \label{DOM_hgr}
 …
 %        Grid files
 % -------------------------------------------------------------------------------------------------------------
 \subsection{Output Grid files}
+\subsection{Output grid files}
 \label{DOM_hgr_files}
 All the arrays relating to a particular ocean model configuration (grid-point
 position, scale factors, masks) can be saved in files if $nn\_msh \not= 0$
+position, scale factors, masks) can be saved in files if \np{nn\_msh} $\not= 0$
 (namelist variable in \ngn{namdom}). This can be particularly useful for plots and off-line
 diagnostics. In some cases, the user may choose to make a local modification
 …
 happens to be too wide due to insufficient model resolution). An example
 is Gibraltar Strait in the ORCA2 configuration. When such modifications are done,
 the output grid written when $nn\_msh \not= 0$ is no more equal to the input grid.
+the output grid written when \np{nn\_msh} $\not= 0$ is no more equal to the input grid.
 $\ $\newline    % force a new line
 …
 % Domain: Vertical Grid (domzgr)
 % ================================================================
+\section  [Domain: Vertical Grid (\textit{domzgr})]
+      {Domain: Vertical Grid \small{(\protect\mdl{domzgr} module)} }
+\section{Vertical grid (\protect\mdl{domzgr})}
 \label{DOM_zgr}
 %-----------------------------------------nam_zgr & namdom-------------------------------------------
 …
 (d) hybrid $s-z$ coordinate,
 (e) hybrid $s-z$ coordinate with partial step, and
 (f) same as (e) but in the non-linear free surface (\protect\forcode{ln_linssh = .false.}).
+(f) same as (e) but in the non-linear free surface (\np{ln\_linssh}\forcode{ = .false.}).
 Note that the non-linear free surface can be used with any of the
 coordinates (a) to (e).}
 …
 option which can be enabled or disabled in the middle of an experiment. Three main
 choices are offered (Fig.~\ref{Fig_z_zps_s_sps}a to c): $z$-coordinate with full step
 bathymetry (\np{ln_zco}~=~true), $z$-coordinate with partial step bathymetry
 (\np{ln_zps}~=~true), or generalized, $s$-coordinate (\np{ln_sco}~=~true).
+bathymetry (\np{ln\_zco}\forcode{ = .true.}), $z$-coordinate with partial step bathymetry
+(\np{ln\_zps}\forcode{ = .true.}), or generalized, $s$-coordinate (\np{ln\_sco}\forcode{ = .true.}).
 Hybridation of the three main coordinates are available: $s-z$ or $s-zps$ coordinate
 (Fig.~\ref{Fig_z_zps_s_sps}d and \ref{Fig_z_zps_s_sps}e). By default a non-linear free surface is used:
 the coordinate follow the time-variation of the free surface so that the transformation is time dependent:
 $z(i,j,k,t)$ (Fig.~\ref{Fig_z_zps_s_sps}f). When a linear free surface is assumed (\forcode{ln_linssh = .true.}),
+$z(i,j,k,t)$ (Fig.~\ref{Fig_z_zps_s_sps}f). When a linear free surface is assumed (\np{ln\_linssh}\forcode{ = .true.}),
 the vertical coordinate are fixed in time, but the seawater can move up and down across the z=0 surface
 (in other words, the top of the ocean in not a rigid-lid).
 The last choice in terms of vertical coordinate concerns the presence (or not) in the model domain
 of ocean cavities beneath ice shelves. Setting \np{ln_isfcav} to true allows to manage ocean cavities,
+of ocean cavities beneath ice shelves. Setting \np{ln\_isfcav} to true allows to manage ocean cavities,
 otherwise they are filled in. This option is currently only available in $z$- or $zps$-coordinate,
 and partial step are also applied at the ocean/ice shelf interface.
 …
 \ifile{bathy\_meter} file, so that the computation of the number of wet ocean point
 in each water column is by-passed}.
 If \np{ln_isfcav}~=~true, an extra file input file describing the ice shelf draft
+If \np{ln\_isfcav}\forcode{ = .true.}, an extra file input file describing the ice shelf draft
 (in meters) (\ifile{isf\_draft\_meter}) is needed.
 …
 %%%
 Unless a linear free surface is used (\forcode{ln_linssh = .false.}), the arrays describing
+Unless a linear free surface is used (\np{ln\_linssh}\forcode{ = .false.}), the arrays describing
 the grid point depths and vertical scale factors are three set of three dimensional arrays $(i,j,k)$
 defined at \textit{before}, \textit{now} and \textit{after} time step. The time at which they are
 defined is indicated by a suffix:$\_b$, $\_n$, or $\_a$, respectively. They are updated at each model time step
 using a fixed reference coordinate system which computer names have a $\_0$ suffix.
 When the linear free surface option is used (\forcode{ln_linssh = .true.}), \textit{before}, \textit{now}
+When the linear free surface option is used (\np{ln\_linssh}\forcode{ = .true.}), \textit{before}, \textit{now}
 and \textit{after} arrays are simply set one for all to their reference counterpart.
 …
 %        Meter Bathymetry
 % -------------------------------------------------------------------------------------------------------------
 \subsection{Meter Bathymetry}
+\subsection{Meter bathymetry}
 \label{DOM_bathy}
 Three options are possible for defining the bathymetry, according to the
 namelist variable \np{nn_bathy} (found in \ngn{namdom} namelist):
+namelist variable \np{nn\_bathy} (found in \ngn{namdom} namelist):
 \begin{description}
 \item[\np{nn_bathy} = 0] a flat-bottom domain is defined. The total depth $z_w (jpk)$
+\item[\np{nn\_bathy}\forcode{ = 0}]: a flat-bottom domain is defined. The total depth $z_w (jpk)$
 is given by the coordinate transformation. The domain can either be a closed
 basin or a periodic channel depending on the parameter \np{jperio}.
 \item[\np{nn_bathy} = -1] a domain with a bump of topography one third of the
+\item[\np{nn\_bathy}\forcode{ = -1}]: a domain with a bump of topography one third of the
 domain width at the central latitude. This is meant for the "EEL-R5" configuration,
 a periodic or open boundary channel with a seamount.
 \item[\np{nn_bathy} = 1] read a bathymetry and ice shelf draft (if needed).
+\item[\np{nn\_bathy}\forcode{ = 1}]: read a bathymetry and ice shelf draft (if needed).
  The \ifile{bathy\_meter} file (Netcdf format) provides the ocean depth (positive, in meters)
  at each grid point of the model grid. The bathymetry is usually built by interpolating a standard bathymetry product
 …
 The \ifile{isfdraft\_meter} file (Netcdf format) provides the ice shelf draft (positive, in meters)
  at each grid point of the model grid. This file is only needed if \np{ln_isfcav}~=~true.
+ at each grid point of the model grid. This file is only needed if \np{ln\_isfcav}\forcode{ = .true.}.
 Defining the ice shelf draft will also define the ice shelf edge and the grounding line position.
 \end{description}
 …
 %        z-coordinate  and reference coordinate transformation
 % -------------------------------------------------------------------------------------------------------------
 \subsection[$z$-coordinate (\protect\np{ln_zco}]
         {$z$-coordinate (\protect\forcode{ln_zco = .true.}) and reference coordinate}
+\subsection[$Z$-coordinate (\protect\np{ln\_zco}\forcode{ = .true.}) and ref. coordinate]
+            {$Z$-coordinate (\protect\np{ln\_zco}\forcode{ = .true.}) and reference coordinate}
 \label{DOM_zco}
 …
 (Fig.~\ref{Fig_zgr}).
 If the ice shelf cavities are opened (\np{ln_isfcav}=~true~), the definition of $z_0$ is the same.
+If the ice shelf cavities are opened (\np{ln\_isfcav}\forcode{ = .true.}), the definition of $z_0$ is the same.
 However, definition of $e_3^0$ at $t$- and $w$-points is respectively changed to:
 \begin{equation} \label{DOM_zgr_ana}
 …
 Rather than entering parameters $h_{sur}$, $h_{0}$, and $h_{1}$ directly, it is
 possible to recalculate them. In that case the user sets
 \np{ppsur}=\np{ppa0}=\forcode{ppa1 = 999999}., in \ngn{namcfg} namelist,
+\np{ppsur}\forcode{ = }\np{ppa0}\forcode{ = }\np{ppa1}\forcode{ = 999999}., in \ngn{namcfg} namelist,
 and specifies instead the four following parameters:
 \begin{itemize}
 …
 \end{itemize}
 As an example, for the $45$ layers used in the DRAKKAR configuration those
+parameters are: \jp{jpk}=46, \forcode{ppacr = 9}, \forcode{ppkth = 23}.563, \forcode{ppdzmin = 6}m,
+\forcode{pphmax = 5750}m.
+parameters are: \jp{jpk}\forcode{ = 46}, \np{ppacr}\forcode{ = 9}, \np{ppkth}\forcode{ = 23.563}, \np{ppdzmin}\forcode{ = 6}m, \np{pphmax}\forcode{ = 5750}m.
 %>>>>>>>>>>>>>>>>>>>>>>>>>>>>
 …
 %        z-coordinate with partial step
 % -------------------------------------------------------------------------------------------------------------
+\subsection   [$z$-coordinate with partial step (\protect\np{ln_zps})]
+         {$z$-coordinate with partial step (\protect\np{ln_zps}=.true.)}
+\subsection{$Z$-coordinate with partial step (\protect\np{ln\_zps}\forcode{ = .true.})}
 \label{DOM_zps}
 %--------------------------------------------namdom-------------------------------------------------------
 …
 Two variables in the namdom namelist are used to define the partial step
 vertical grid. The mimimum water thickness (in meters) allowed for a cell
 partially filled with bathymetry at level jk is the minimum of \np{rn_e3zps_min}
 (thickness in meters, usually $20~m$) or $e_{3t}(jk)*rn\_e3zps\_rat$ (a fraction,
+partially filled with bathymetry at level jk is the minimum of \np{rn\_e3zps\_min}
+(thickness in meters, usually $20~m$) or $e_{3t}(jk)*$\np{rn\_e3zps\_rat} (a fraction,
 usually 10\%, of the default thickness $e_{3t}(jk)$).
 …
 %        s-coordinate
 % -------------------------------------------------------------------------------------------------------------
+\subsection   [$s$-coordinate (\protect\np{ln_sco})]
+           {$s$-coordinate (\protect\forcode{ln_sco = .true.})}
+\subsection{$S$-coordinate (\protect\np{ln\_sco}\forcode{ = .true.})}
 \label{DOM_sco}
 %------------------------------------------nam_zgr_sco---------------------------------------------------
 …
 %--------------------------------------------------------------------------------------------------------------
 Options are defined in \ngn{namzgr\_sco}.
 In $s$-coordinate (\np{ln_sco}~=~true), the depth and thickness of the model
+In $s$-coordinate (\np{ln\_sco}\forcode{ = .true.}), the depth and thickness of the model
 levels are defined from the product of a depth field and either a stretching
 function or its derivative, respectively:
 …
 depth, since a mixed step-like and bottom-following representation of the
 topography can be used (Fig.~\ref{Fig_z_zps_s_sps}d-e) or an envelop bathymetry can be defined (Fig.~\ref{Fig_z_zps_s_sps}f).
 The namelist parameter \np{rn_rmax} determines the slope at which the terrain-following coordinate intersects
+The namelist parameter \np{rn\_rmax} determines the slope at which the terrain-following coordinate intersects
 the sea bed and becomes a pseudo z-coordinate.
 The coordinate can also be hybridised by specifying \np{rn_sbot_min} and \np{rn_sbot_max}
+The coordinate can also be hybridised by specifying \np{rn\_sbot\_min} and \np{rn\_sbot\_max}
 as the minimum and maximum depths at which the terrain-following vertical coordinate is calculated.
 …
 The original default NEMO s-coordinate stretching is available if neither of the other options
 are specified as true (\np{ln_s_SH94}~=~false and \np{ln_s_SF12}~=~false).
+are specified as true (\np{ln\_s\_SH94}\forcode{ = .false.} and \np{ln\_s\_SF12}\forcode{ = .false.}).
 This uses a depth independent $\tanh$ function for the stretching \citep{Madec_al_JPO96}:
 …
 A stretching function, modified from the commonly used \citet{Song_Haidvogel_JCP94}
 stretching (\np{ln_s_SH94}~=~true), is also available and is more commonly used for shelf seas modelling:
+stretching (\np{ln\_s\_SH94}\forcode{ = .true.}), is also available and is more commonly used for shelf seas modelling:
 \begin{equation}
 …
 %>>>>>>>>>>>>>>>>>>>>>>>>>>>>
 where $H_c$ is the critical depth (\np{rn_hc}) at which the coordinate transitions from
 pure $\sigma$ to the stretched coordinate,  and $\theta$ (\np{rn_theta}) and $b$ (\np{rn_bb})
+where $H_c$ is the critical depth (\np{rn\_hc}) at which the coordinate transitions from
+pure $\sigma$ to the stretched coordinate,  and $\theta$ (\np{rn\_theta}) and $b$ (\np{rn\_bb})
 are the surface and bottom control parameters such that $0\leqslant \theta \leqslant 20$, and
 $0\leqslant b\leqslant 1$. $b$ has been designed to allow surface and/or bottom
 increase of the vertical resolution (Fig.~\ref{Fig_sco_function}).
 Another example has been provided at version 3.5 (\np{ln_s_SF12}) that allows
+Another example has been provided at version 3.5 (\np{ln\_s\_SF12}) that allows
 a fixed surface resolution in an analytical terrain-following stretching \citet{Siddorn_Furner_OM12}.
 In this case the a stretching function $\gamma$ is defined such that:
 …
 This gives an analytical stretching of $\sigma$ that is solvable in $A$ and $B$ as a function of
 the user prescribed stretching parameter $\alpha$ (\np{rn_alpha}) that stretches towards
 the surface ($\alpha > 1.0$) or the bottom ($\alpha < 1.0$) and user prescribed surface (\np{rn_zs})
+the user prescribed stretching parameter $\alpha$ (\np{rn\_alpha}) that stretches towards
+the surface ($\alpha > 1.0$) or the bottom ($\alpha < 1.0$) and user prescribed surface (\np{rn\_zs})
 and bottom depths. The bottom cell depth in this example is given as a function of water depth:
 …
 \end{equation}
 where the namelist parameters \np{rn_zb_a} and \np{rn_zb_b} are $a$ and $b$ respectively.
+where the namelist parameters \np{rn\_zb\_a} and \np{rn\_zb\_b} are $a$ and $b$ respectively.
 %>>>>>>>>>>>>>>>>>>>>>>>>>>>>
 …
 This gives a smooth analytical stretching in computational space that is constrained to given specified surface and bottom grid cell thicknesses in real space. This is not to be confused with the hybrid schemes that superimpose geopotential coordinates on terrain following coordinates thus creating a non-analytical vertical coordinate that therefore may suffer from large gradients in the vertical resolutions. This stretching is less straightforward to implement than the \citet{Song_Haidvogel_JCP94} stretching, but has the advantage of resolving diurnal processes in deep water and has generally flatter slopes.
 As with the \citet{Song_Haidvogel_JCP94} stretching the stretch is only applied at depths greater than the critical depth $h_c$. In this example two options are available in depths shallower than $h_c$, with pure sigma being applied if the \np{ln_sigcrit} is true and pure z-coordinates if it is false (the z-coordinate being equal to the depths of the stretched coordinate at $h_c$.
+As with the \citet{Song_Haidvogel_JCP94} stretching the stretch is only applied at depths greater than the critical depth $h_c$. In this example two options are available in depths shallower than $h_c$, with pure sigma being applied if the \np{ln\_sigcrit} is true and pure z-coordinates if it is false (the z-coordinate being equal to the depths of the stretched coordinate at $h_c$.
 Minimising the horizontal slope of the vertical coordinate is important in terrain-following systems as large slopes lead to hydrostatic consistency. A hydrostatic consistency parameter diagnostic following \citet{Haney1991} has been implemented, and is output as part of the model mesh file at the start of the run.
 …
 %        z*- or s*-coordinate
 % -------------------------------------------------------------------------------------------------------------
 \subsection{$z^*$- or $s^*$-coordinate (\protect\forcode{ln_linssh = .false.}) }
+\subsection{$Z^*$- or $S^*$-coordinate (\protect\np{ln\_linssh}\forcode{ = .false.}) }
 \label{DOM_zgr_star}
 …
 %        level bathymetry and mask
 % -------------------------------------------------------------------------------------------------------------
 \subsection{level bathymetry and mask}
+\subsection{Level bathymetry and mask}
 \label{DOM_msk}
 …
 In case of ice shelf cavities, modifications of the model bathymetry and ice shelf draft into
 the cavities are performed in the \textit{zgr\_isf} routine. The compatibility between ice shelf draft and bathymetry is checked.
 All the locations where the isf cavity is thinnest than \np{rn_isfhmin} meters are grounded ($i.e.$ masked).
+All the locations where the isf cavity is thinnest than \np{rn\_isfhmin} meters are grounded ($i.e.$ masked).
 If only one cell on the water column is opened at $t$-, $u$- or $v$-points, the bathymetry or the ice shelf draft is dug to fit this constrain.
 If the incompatibility is too strong (need to dig more than 1 cell), the cell is masked.\\
 …
 % Domain: Initial State (dtatsd & istate)
 % ================================================================
+\section  [Domain: Initial State (\textit{istate and dtatsd})]
+      {Domain: Initial State \small{(\protect\mdl{istate} and \protect\mdl{dtatsd} modules)} }
+\section{Initial state (\protect\mdl{istate} and \protect\mdl{dtatsd})}
 \label{DTA_tsd}
 %-----------------------------------------namtsd-------------------------------------------
 …
 Options are defined in \ngn{namtsd}.
 By default, the ocean start from rest (the velocity field is set to zero) and the initialization of
 temperature and salinity fields is controlled through the \np{ln_tsd_ini} namelist parameter.
+temperature and salinity fields is controlled through the \np{ln\_tsd\_ini} namelist parameter.
 \begin{description}
 \item[ln\_tsd\_init = .true.]  use a T and S input files that can be given on the model grid itself or
+\item[\np{ln\_tsd\_init}\forcode{ = .true.}] use a T and S input files that can be given on the model grid itself or
 on their native input data grid. In the latter case, the data will be interpolated on-the-fly both in the
 horizontal and the vertical to the model grid (see \S~\ref{SBC_iof}). The information relative to the
 input files are given in the \np{sn_tem} and \np{sn_sal} structures.
+input files are given in the \np{sn\_tem} and \np{sn\_sal} structures.
 The computation is done in the \mdl{dtatsd} module.
 \item[ln\_tsd\_init = .false.] use constant salinity value of 35.5 psu and an analytical profile of temperature
+\item[\np{ln\_tsd\_init}\forcode{ = .false.}] use constant salinity value of 35.5 psu and an analytical profile of temperature
 (typical of the tropical ocean), see \rou{istate\_t\_s} subroutine called from \mdl{istate} module.
 \end{description}

branches/2017/dev_merge_2017/DOC/tex_sub/chap_DYN.tex

-                      r9392
+                      r9393
 %           Horizontal divergence and relative vorticity
 %--------------------------------------------------------------------------------------------------------------
+\subsection   [Horizontal divergence and relative vorticity (\textit{divcur})]
+         {Horizontal divergence and relative vorticity (\protect\mdl{divcur})}
+\subsection{Horizontal divergence and relative vorticity (\protect\mdl{divcur})}
 \label{DYN_divcur}
 …
 %           Sea Surface Height evolution
 %--------------------------------------------------------------------------------------------------------------
+\subsection   [Sea surface height evolution and vertical velocity (\textit{sshwzv})]
+         {Horizontal divergence and relative vorticity (\protect\mdl{sshwzv})}
+\subsection{Horizontal divergence and relative vorticity (\protect\mdl{sshwzv})}
 \label{DYN_sshwzv}
 …
 % Coriolis and Advection terms: vector invariant form
 % ================================================================
 \section{Coriolis and Advection: vector invariant form}
+\section{Coriolis and advection: vector invariant form}
 \label{DYN_adv_cor_vect}
 %-----------------------------------------nam_dynadv----------------------------------------------------
 …
 %        Vorticity term
 % -------------------------------------------------------------------------------------------------------------
+\subsection   [Vorticity term (\textit{dynvor}) ]
+         {Vorticity term (\protect\mdl{dynvor})}
+\subsection{Vorticity term (\protect\mdl{dynvor})}
 \label{DYN_vor}
 %------------------------------------------nam_dynvor----------------------------------------------------
 …
 Options are defined through the \ngn{namdyn\_vor} namelist variables.
 Four discretisations of the vorticity term (\textit{ln\_dynvor\_xxx}=true) are available:
+Four discretisations of the vorticity term (\np{ln\_dynvor\_xxx}\forcode{ = .true.}) are available:
 conserving potential enstrophy of horizontally non-divergent flow (ENS scheme) ;
 conserving horizontal kinetic energy (ENE scheme) ; conserving potential enstrophy for
 …
 flow and horizontal kinetic energy (EEN scheme) (see  Appendix~\ref{Apdx_C_vorEEN}). In the
 case of ENS, ENE or MIX schemes the land sea mask may be slightly modified to ensure the
 consistency of vorticity term with analytical equations (\textit{ln\_dynvor\_con}=true).
+consistency of vorticity term with analytical equations (\np{ln\_dynvor\_con}\forcode{ = .true.}).
 The vorticity terms are all computed in dedicated routines that can be found in
 the \mdl{dynvor} module.
 …
 %                 enstrophy conserving scheme
 %-------------------------------------------------------------
 \subsubsection{Enstrophy conserving scheme (\protect\forcode{ln_dynvor_ens = .true.})}
+\subsubsection{Enstrophy conserving scheme (\protect\np{ln\_dynvor\_ens}\forcode{ = .true.})}
 \label{DYN_vor_ens}
 …
 %                 energy conserving scheme
 %-------------------------------------------------------------
 \subsubsection{Energy conserving scheme (\protect\forcode{ln_dynvor_ene = .true.})}
+\subsubsection{Energy conserving scheme (\protect\np{ln\_dynvor\_ene}\forcode{ = .true.})}
 \label{DYN_vor_ene}
 …
 %                 mix energy/enstrophy conserving scheme
 %-------------------------------------------------------------
 \subsubsection{Mixed energy/enstrophy conserving scheme (\protect\forcode{ln_dynvor_mix = .true.}) }
+\subsubsection{Mixed energy/enstrophy conserving scheme (\protect\np{ln\_dynvor\_mix}\forcode{ = .true.}) }
 \label{DYN_vor_mix}
 …
 %                 energy and enstrophy conserving scheme
 %-------------------------------------------------------------
 \subsubsection{Energy and enstrophy conserving scheme (\protect\forcode{ln_dynvor_een = .true.}) }
+\subsubsection{Energy and enstrophy conserving scheme (\protect\np{ln\_dynvor\_een}\forcode{ = .true.}) }
 \label{DYN_vor_een}
 …
 A key point in \eqref{Eq_een_e3f} is how the averaging in the \textbf{i}- and \textbf{j}- directions is made.
 It uses the sum of masked t-point vertical scale factor divided either
 by the sum of the four t-point masks (\np{nn_een_e3f}~=~1),
 or  just by $4$ (\np{nn_een_e3f}~=~true).
+by the sum of the four t-point masks (\np{nn\_een\_e3f}\forcode{ = 1}),
+or  just by $4$ (\np{nn\_een\_e3f}\forcode{ = .true.}).
 The latter case preserves the continuity of $e_{3f}$ when one or more of the neighbouring $e_{3t}$
 tends to zero and extends by continuity the value of $e_{3f}$ into the land areas.
 …
 %           Kinetic Energy Gradient term
 %--------------------------------------------------------------------------------------------------------------
+\subsection   [Kinetic Energy Gradient term (\textit{dynkeg})]
+         {Kinetic Energy Gradient term (\protect\mdl{dynkeg})}
+\subsection{Kinetic energy gradient term (\protect\mdl{dynkeg})}
 \label{DYN_keg}
 …
 %           Vertical advection term
 %--------------------------------------------------------------------------------------------------------------
+\subsection   [Vertical advection term (\textit{dynzad}) ]
+         {Vertical advection term (\protect\mdl{dynzad}) }
+\subsection{Vertical advection term (\protect\mdl{dynzad}) }
 \label{DYN_zad}
 …
 \end{aligned}         \right.
 \end{equation}
 When \np{ln_dynzad_zts}~=~\textit{true}, a split-explicit time stepping with 5 sub-timesteps is used
+When \np{ln\_dynzad\_zts}\forcode{ = .true.}, a split-explicit time stepping with 5 sub-timesteps is used
 on the vertical advection term.
 This option can be useful when the value of the timestep is limited by vertical advection \citep{Lemarie_OM2015}.
 Note that in this case, a similar split-explicit time stepping should be used on
 vertical advection of tracer to ensure a better stability,
 an option which is only available with a TVD scheme (see \np{ln_traadv_tvd_zts} in \S\ref{TRA_adv_tvd}).
+an option which is only available with a TVD scheme (see \np{ln\_traadv\_tvd\_zts} in \S\ref{TRA_adv_tvd}).
 …
 % Coriolis and Advection : flux form
 % ================================================================
 \section{Coriolis and Advection: flux form}
+\section{Coriolis and advection: flux form}
 \label{DYN_adv_cor_flux}
 %------------------------------------------nam_dynadv----------------------------------------------------
 …
 %           Coriolis plus curvature metric terms
 %--------------------------------------------------------------------------------------------------------------
+\subsection   [Coriolis plus curvature metric terms (\textit{dynvor}) ]
+         {Coriolis plus curvature metric terms (\protect\mdl{dynvor}) }
+\subsection{Coriolis plus curvature metric terms (\protect\mdl{dynvor}) }
 \label{DYN_cor_flux}
 …
 %           Flux form Advection term
 %--------------------------------------------------------------------------------------------------------------
+\subsection   [Flux form Advection term (\textit{dynadv}) ]
+         {Flux form Advection term (\protect\mdl{dynadv}) }
+\subsection{Flux form advection term (\protect\mdl{dynadv}) }
 \label{DYN_adv_flux}
 …
 difference scheme, CEN2, or a $3^{rd}$ order upstream biased scheme, UBS.
 The latter is described in \citet{Shchepetkin_McWilliams_OM05}. The schemes are
 selected using the namelist logicals \np{ln_dynadv_cen2} and \np{ln_dynadv_ubs}.
+selected using the namelist logicals \np{ln\_dynadv\_cen2} and \np{ln\_dynadv\_ubs}.
 In flux form, the schemes differ by the choice of a space and time interpolation to
 define the value of $u$ and $v$ at the centre of each face of $u$- and $v$-cells,
 …
 %                 2nd order centred scheme
 %-------------------------------------------------------------
 \subsubsection{$2^{nd}$ order centred scheme (cen2) (\protect\forcode{ln_dynadv_cen2 = .true.})}
+\subsubsection{CEN2: $2^{nd}$ order centred scheme (\protect\np{ln\_dynadv\_cen2}\forcode{ = .true.})}
 \label{DYN_adv_cen2}
 …
 %                 UBS scheme
 %-------------------------------------------------------------
 \subsubsection{Upstream Biased Scheme (UBS) (\protect\forcode{ln_dynadv_ubs = .true.})}
+\subsubsection{UBS: Upstream Biased Scheme (\protect\np{ln\_dynadv\_ubs}\forcode{ = .true.})}
 \label{DYN_adv_ubs}
 …
 permitted. But the amplitudes of the false extrema are significantly reduced over
 those in the centred second order method. As the scheme already includes
 a diffusion component, it can be used without explicit  lateral diffusion on momentum
 ($i.e.$ \np{ln_dynldf_lap}=\forcode{ln_dynldf_bilap = .false.}), and it is recommended to do so.
+a diffusion component, it can be used without explicit lateral diffusion on momentum
+($i.e.$ \np{ln\_dynldf\_lap}\forcode{ = }\np{ln\_dynldf\_bilap}\forcode{ = .false.}), and it is recommended to do so.
 The UBS scheme is not used in all directions. In the vertical, the centred $2^{nd}$
 …
 %           Hydrostatic pressure gradient term
 % ================================================================
+\section  [Hydrostatic pressure gradient (\textit{dynhpg})]
+      {Hydrostatic pressure gradient (\protect\mdl{dynhpg})}
+\section{Hydrostatic pressure gradient (\protect\mdl{dynhpg})}
 \label{DYN_hpg}
 %------------------------------------------nam_dynhpg---------------------------------------------------
 …
 %           z-coordinate with full step
 %--------------------------------------------------------------------------------------------------------------
+\subsection   [$z$-coordinate with full step (\protect\np{ln_dynhpg_zco}) ]
+         {$z$-coordinate with full step (\protect\forcode{ln_dynhpg_zco = .true.})}
+\subsection{Full step $Z$-coordinate (\protect\np{ln\_dynhpg\_zco}\forcode{ = .true.})}
 \label{DYN_hpg_zco}
 …
 %           z-coordinate with partial step
 %--------------------------------------------------------------------------------------------------------------
+\subsection   [$z$-coordinate with partial step (\protect\np{ln_dynhpg_zps})]
+         {$z$-coordinate with partial step (\protect\forcode{ln_dynhpg_zps = .true.})}
+\subsection{Partial step $Z$-coordinate (\protect\np{ln\_dynhpg\_zps}\forcode{ = .true.})}
 \label{DYN_hpg_zps}
 …
 %           s- and s-z-coordinates
 %--------------------------------------------------------------------------------------------------------------
 \subsection{$s$- and $z$-$s$-coordinates}
+\subsection{$S$- and $Z$-$S$-coordinates}
 \label{DYN_hpg_sco}
 …
 cubic polynomial method is currently disabled whilst known bugs are under investigation.
 $\bullet$ Traditional coding (see for example \citet{Madec_al_JPO96}: (\forcode{ln_dynhpg_sco = .true.})
+$\bullet$ Traditional coding (see for example \citet{Madec_al_JPO96}: (\np{ln\_dynhpg\_sco}\forcode{ = .true.})
 \begin{equation} \label{Eq_dynhpg_sco}
 \left\{ \begin{aligned}
 …
 ($e_{3w}$).
 $\bullet$ Traditional coding with adaptation for ice shelf cavities (\forcode{ln_dynhpg_isf = .true.}).
 This scheme need the activation of ice shelf cavities (\forcode{ln_isfcav = .true.}).
 $\bullet$ Pressure Jacobian scheme (prj) (a research paper in preparation) (\forcode{ln_dynhpg_prj = .true.})
+$\bullet$ Traditional coding with adaptation for ice shelf cavities (\np{ln\_dynhpg\_isf}\forcode{ = .true.}).
+This scheme need the activation of ice shelf cavities (\np{ln\_isfcav}\forcode{ = .true.}).
+$\bullet$ Pressure Jacobian scheme (prj) (a research paper in preparation) (\np{ln\_dynhpg\_prj}\forcode{ = .true.})
 $\bullet$ Density Jacobian with cubic polynomial scheme (DJC) \citep{Shchepetkin_McWilliams_OM05}
 (\forcode{ln_dynhpg_djc = .true.}) (currently disabled; under development)
+(\np{ln\_dynhpg\_djc}\forcode{ = .true.}) (currently disabled; under development)
 Note that expression \eqref{Eq_dynhpg_sco} is commonly used when the variable volume formulation is
 activated (\key{vvl}) because in that case, even with a flat bottom, the coordinate surfaces are not
 horizontal but follow the free surface \citep{Levier2007}. The pressure jacobian scheme
 (\forcode{ln_dynhpg_prj = .true.}) is available as an improved option to \forcode{ln_dynhpg_sco = .true.} when
+(\np{ln\_dynhpg\_prj}\forcode{ = .true.}) is available as an improved option to \np{ln\_dynhpg\_sco}\forcode{ = .true.} when
 \key{vvl} is active.  The pressure Jacobian scheme uses a constrained cubic spline to reconstruct
 the density profile across the water column. This method maintains the monotonicity between the
 …
 \label{DYN_hpg_isf}
 Beneath an ice shelf, the total pressure gradient is the sum of the pressure gradient due to the ice shelf load and
  the pressure gradient due to the ocean load. If cavity opened (\np{ln_isfcav}~=~true) these 2 terms can be
  calculated by setting \np{ln_dynhpg_isf}~=~true. No other scheme are working with the ice shelf.\\
+ the pressure gradient due to the ocean load. If cavity opened (\np{ln\_isfcav}\forcode{ = .true.}) these 2 terms can be
+ calculated by setting \np{ln\_dynhpg\_isf}\forcode{ = .true.}. No other scheme are working with the ice shelf.\\
 $\bullet$ The main hypothesis to compute the ice shelf load is that the ice shelf is in an isostatic equilibrium.
 …
 %           Time-scheme
 %--------------------------------------------------------------------------------------------------------------
+\subsection   [Time-scheme (\protect\np{ln_dynhpg_imp}) ]
+         {Time-scheme (\protect\np{ln_dynhpg_imp}= true/false)}
+\subsection{Time-scheme (\protect\np{ln\_dynhpg\_imp}\forcode{ = .true./.false.})}
 \label{DYN_hpg_imp}
 …
 time level $t$ only, as in the standard leapfrog scheme.
 $\bullet$ leapfrog scheme (\forcode{ln_dynhpg_imp = .true.}):
+$\bullet$ leapfrog scheme (\np{ln\_dynhpg\_imp}\forcode{ = .true.}):
 \begin{equation} \label{Eq_dynhpg_lf}
 …
 \end{equation}
 $\bullet$ semi-implicit scheme (\forcode{ln_dynhpg_imp = .true.}):
+$\bullet$ semi-implicit scheme (\np{ln\_dynhpg\_imp}\forcode{ = .true.}):
 \begin{equation} \label{Eq_dynhpg_imp}
 \frac{u^{t+\rdt}-u^{t-\rdt}}{2\rdt} = \;\cdots \;
 …
 the stability limits associated with advection or diffusion.
 In practice, the semi-implicit scheme is used when \forcode{ln_dynhpg_imp = .true.}.
+In practice, the semi-implicit scheme is used when \np{ln\_dynhpg\_imp}\forcode{ = .true.}.
 In this case, we choose to apply the time filter to temperature and salinity used in
 the equation of state, instead of applying it to the hydrostatic pressure or to the
 …
 Note that in the semi-implicit case, it is necessary to save the filtered density, an
 extra three-dimensional field, in the restart file to restart the model with exact
 reproducibility. This option is controlled by  \np{nn_dynhpg_rst}, a namelist parameter.
+reproducibility. This option is controlled by  \np{nn\_dynhpg\_rst}, a namelist parameter.
 % ================================================================
 % Surface Pressure Gradient
 % ================================================================
+\section  [Surface pressure gradient (\textit{dynspg}) ]
+      {Surface pressure gradient (\protect\mdl{dynspg})}
+\section{Surface pressure gradient (\protect\mdl{dynspg})}
 \label{DYN_spg}
 %-----------------------------------------nam_dynspg----------------------------------------------------
 …
 % Split-explict free surface formulation
 %--------------------------------------------------------------------------------------------------------------
 \subsection{Split-Explicit free surface (\protect\key{dynspg\_ts})}
+\subsection{Split-explicit free surface (\protect\key{dynspg\_ts})}
 \label{DYN_spg_ts}
 %------------------------------------------namsplit-----------------------------------------------------------
 …
 variables (Fig.~\ref{Fig_DYN_dynspg_ts}).
 The size of the small time step, $\rdt_e$ (the external mode or barotropic time step)
  is provided through the \np{nn_baro} namelist parameter as:
 $\rdt_e = \rdt / nn\_baro$. This parameter can be optionally defined automatically (\forcode{ln_bt_nn_auto = .true.})
+ is provided through the \np{nn\_baro} namelist parameter as:
+$\rdt_e = \rdt / nn\_baro$. This parameter can be optionally defined automatically (\np{ln\_bt\_nn\_auto}\forcode{ = .true.})
 considering that the stability of the barotropic system is essentially controled by external waves propagation.
 Maximum Courant number is in that case time independent, and easily computed online from the input bathymetry.
 Therefore, $\rdt_e$ is adjusted so that the Maximum allowed Courant number is smaller than \np{rn_bt_cmax}.
+Therefore, $\rdt_e$ is adjusted so that the Maximum allowed Courant number is smaller than \np{rn\_bt\_cmax}.
 %%%
 …
 The former are used to obtain time filtered quantities at $t+\rdt$ while the latter are used to obtain time averaged
 transports to advect tracers.
 a) Forward time integration: \protect\forcode{ln_bt_fw = .true.},  \protect\forcode{ln_bt_av = .true.}.
 b) Centred time integration: \protect\forcode{ln_bt_fw = .false.}, \protect\forcode{ln_bt_av = .true.}.
 c) Forward time integration with no time filtering (POM-like scheme): \protect\forcode{ln_bt_fw = .true.}, \protect\forcode{ln_bt_av = .false.}. }
+a) Forward time integration: \np{ln\_bt\_fw}\forcode{ = .true.},  \np{ln\_bt\_av}\forcode{ = .true.}.
+b) Centred time integration: \np{ln\_bt\_fw}\forcode{ = .false.}, \np{ln\_bt\_av}\forcode{ = .true.}.
+c) Forward time integration with no time filtering (POM-like scheme): \np{ln\_bt\_fw}\forcode{ = .true.}, \np{ln\_bt\_av}\forcode{ = .false.}. }
 \end{center}    \end{figure}
 %>   >   >   >   >   >   >   >   >   >   >   >   >   >   >   >   >   >   >   >   >   >   >   >   >   >   >   >
 In the default case (\forcode{ln_bt_fw = .true.}), the external mode is integrated
+In the default case (\np{ln\_bt\_fw}\forcode{ = .true.}), the external mode is integrated
 between \textit{now} and  \textit{after} baroclinic time-steps (Fig.~\ref{Fig_DYN_dynspg_ts}a). To avoid aliasing of fast barotropic motions into three dimensional equations, time filtering is eventually applied on barotropic
 quantities (\forcode{ln_bt_av = .true.}). In that case, the integration is extended slightly beyond  \textit{after} time step to provide time filtered quantities.
+quantities (\np{ln\_bt\_av}\forcode{ = .true.}). In that case, the integration is extended slightly beyond  \textit{after} time step to provide time filtered quantities.
 These are used for the subsequent initialization of the barotropic mode in the following baroclinic step.
 Since external mode equations written at baroclinic time steps finally follow a forward time stepping scheme,
 asselin filtering is not applied to barotropic quantities. \\
 Alternatively, one can choose to integrate barotropic equations starting
 from \textit{before} time step (\forcode{ln_bt_fw = .false.}). Although more computationaly expensive ( \np{nn_baro} additional iterations are indeed necessary), the baroclinic to barotropic forcing term given at \textit{now} time step
+from \textit{before} time step (\np{ln\_bt\_fw}\forcode{ = .false.}). Although more computationaly expensive ( \np{nn\_baro} additional iterations are indeed necessary), the baroclinic to barotropic forcing term given at \textit{now} time step
 become centred in the middle of the integration window. It can easily be shown that this property
 removes part of splitting errors between modes, which increases the overall numerical robustness.
 …
 %%%
 One can eventually choose to feedback instantaneous values by not using any time filter (\forcode{ln_bt_av = .false.}).
+One can eventually choose to feedback instantaneous values by not using any time filter (\np{ln\_bt\_av}\forcode{ = .false.}).
 In that case, external mode equations are continuous in time, ie they are not re-initialized when starting a new
 sub-stepping sequence. This is the method used so far in the POM model, the stability being maintained by refreshing at (almost)
 …
 % Lateral diffusion term
 % ================================================================
+\section  [Lateral diffusion term (\textit{dynldf})]
+      {Lateral diffusion term (\protect\mdl{dynldf})}
+\section{Lateral diffusion term and operators (\protect\mdl{dynldf})}
 \label{DYN_ldf}
 %------------------------------------------nam_dynldf----------------------------------------------------
 …
 % ================================================================
 \subsection   [Iso-level laplacian operator (\protect\np{ln_dynldf_lap}) ]
          {Iso-level laplacian operator (\protect\forcode{ln_dynldf_lap = .true.})}
+\subsection[Iso-level laplacian (\protect\np{ln\_dynldf\_lap}\forcode{ = .true.})]
+            {Iso-level laplacian operator (\protect\np{ln\_dynldf\_lap}\forcode{ = .true.})}
 \label{DYN_ldf_lap}
 …
 %           Rotated laplacian operator
 %--------------------------------------------------------------------------------------------------------------
 \subsection   [Rotated laplacian operator (\protect\np{ln_dynldf_iso}) ]
          {Rotated laplacian operator (\protect\forcode{ln_dynldf_iso = .true.})}
+\subsection[Rotated laplacian (\protect\np{ln\_dynldf\_iso}\forcode{ = .true.})]
+            {Rotated laplacian operator (\protect\np{ln\_dynldf\_iso}\forcode{ = .true.})}
 \label{DYN_ldf_iso}
 A rotation of the lateral momentum diffusion operator is needed in several cases:
 for iso-neutral diffusion in the $z$-coordinate (\forcode{ln_dynldf_iso = .true.}) and for
 either iso-neutral (\forcode{ln_dynldf_iso = .true.}) or geopotential
 (\forcode{ln_dynldf_hor = .true.}) diffusion in the $s$-coordinate. In the partial step
+for iso-neutral diffusion in the $z$-coordinate (\np{ln\_dynldf\_iso}\forcode{ = .true.}) and for
+either iso-neutral (\np{ln\_dynldf\_iso}\forcode{ = .true.}) or geopotential
+(\np{ln\_dynldf\_hor}\forcode{ = .true.}) diffusion in the $s$-coordinate. In the partial step
 case, coordinates are horizontal except at the deepest level and no
 rotation is performed when \forcode{ln_dynldf_hor = .true.}. The diffusion operator
+rotation is performed when \np{ln\_dynldf\_hor}\forcode{ = .true.}. The diffusion operator
 is defined simply as the divergence of down gradient momentum fluxes on each
 momentum component. It must be emphasized that this formulation ignores
 …
 %           Iso-level bilaplacian operator
 %--------------------------------------------------------------------------------------------------------------
 \subsection   [Iso-level bilaplacian operator (\protect\np{ln_dynldf_bilap})]
          {Iso-level bilaplacian operator (\protect\forcode{ln_dynldf_bilap = .true.})}
+\subsection[Iso-level bilaplacian (\protect\np{ln\_dynldf\_bilap}\forcode{ = .true.})]
+            {Iso-level bilaplacian operator (\protect\np{ln\_dynldf\_bilap}\forcode{ = .true.})}
 \label{DYN_ldf_bilap}
 …
 %           Vertical diffusion term
 % ================================================================
+\section  [Vertical diffusion term (\protect\mdl{dynzdf})]
+      {Vertical diffusion term (\protect\mdl{dynzdf})}
+\section{Vertical diffusion term (\protect\mdl{dynzdf})}
 \label{DYN_zdf}
 %----------------------------------------------namzdf------------------------------------------------------
 …
 would be too restrictive a constraint on the time step. Two time stepping schemes
 can be used for the vertical diffusion term : $(a)$ a forward time differencing
 scheme (\forcode{ln_zdfexp = .true.}) using a time splitting technique
 (\np{nn_zdfexp} $>$ 1) or $(b)$ a backward (or implicit) time differencing scheme
 (\forcode{ln_zdfexp = .false.}) (see \S\ref{STP}). Note that namelist variables
 \np{ln_zdfexp} and \np{nn_zdfexp} apply to both tracers and dynamics.
+scheme (\np{ln\_zdfexp}\forcode{ = .true.}) using a time splitting technique
+(\np{nn\_zdfexp} $>$ 1) or $(b)$ a backward (or implicit) time differencing scheme
+(\np{ln\_zdfexp}\forcode{ = .false.}) (see \S\ref{STP}). Note that namelist variables
+\np{ln\_zdfexp} and \np{nn\_zdfexp} apply to both tracers and dynamics.
 The formulation of the vertical subgrid scale physics is the same whatever
 …
 % External Forcing
 % ================================================================
 \section{External Forcings}
+\section{External forcings}
 \label{DYN_forcing}
 …
 may enter the dynamical equations by affecting the surface pressure gradient.
 (1) When \np{ln_apr_dyn}~=~true (see \S\ref{SBC_apr}), the atmospheric pressure is taken
+(1) When \np{ln\_apr\_dyn}\forcode{ = .true.} (see \S\ref{SBC_apr}), the atmospheric pressure is taken
 into account when computing the surface pressure gradient.
 (2) When \np{ln_tide_pot}~=~true and \np{ln_tide}~=~true (see \S\ref{SBC_tide}),
+(2) When \np{ln\_tide\_pot}\forcode{ = .true.} and \np{ln\_tide}\forcode{ = .true.} (see \S\ref{SBC_tide}),
 the tidal potential is taken into account when computing the surface pressure gradient.
 (3) When \np{nn_ice_embd}~=~2 and LIM or CICE is used ($i.e.$ when the sea-ice is embedded in the ocean),
+(3) When \np{nn\_ice\_embd}\forcode{ = 2} and LIM or CICE is used ($i.e.$ when the sea-ice is embedded in the ocean),
 the snow-ice mass is taken into account when computing the surface pressure gradient.
 …
 % Time evolution term
 % ================================================================
+\section  [Time evolution term (\textit{dynnxt})]
+      {Time evolution term (\protect\mdl{dynnxt})}
+\section{Time evolution term (\protect\mdl{dynnxt})}
 \label{DYN_nxt}
 …
 weighted velocity (see \S\ref{Apdx_A_momentum})
 $\bullet$ vector invariant form or linear free surface (\forcode{ln_dynhpg_vec = .true.} ; \key{vvl} not defined):
+$\bullet$ vector invariant form or linear free surface (\np{ln\_dynhpg\_vec}\forcode{ = .true.} ; \key{vvl} not defined):
 \begin{equation} \label{Eq_dynnxt_vec}
 \left\{   \begin{aligned}
 …
 \end{equation}
 $\bullet$ flux form and nonlinear free surface (\forcode{ln_dynhpg_vec = .false.} ; \key{vvl} defined):
+$\bullet$ flux form and nonlinear free surface (\np{ln\_dynhpg\_vec}\forcode{ = .false.} ; \key{vvl} defined):
 \begin{equation} \label{Eq_dynnxt_flux}
 \left\{   \begin{aligned}
 …
 where RHS is the right hand side of the momentum equation, the subscript $f$
 denotes filtered values and $\gamma$ is the Asselin coefficient. $\gamma$ is
 initialized as \np{nn_atfp} (namelist parameter). Its default value is \np{nn_atfp} = $10^{-3}$.
+initialized as \np{nn\_atfp} (namelist parameter). Its default value is \np{nn\_atfp}\forcode{ = 10.e-3}.
 In both cases, the modified Asselin filter is not applied since perfect conservation
 is not an issue for the momentum equations.

branches/2017/dev_merge_2017/DOC/tex_sub/chap_LBC.tex

-                      r9392
+                      r9393
 % Chapter — Lateral Boundary Condition (LBC)
 % ================================================================
 \chapter{Lateral Boundary Condition (LBC) }
+\chapter{Lateral Boundary Condition (LBC)}
 \label{LBC}
 \minitoc
 …
 % Boundary Condition at the Coast
 % ================================================================
 \section{Boundary Condition at the Coast (\protect\np{rn_shlat})}
+\section{Boundary condition at the coast (\protect\np{rn\_shlat})}
 \label{LBC_coast}
 %--------------------------------------------nam_lbc-------------------------------------------------------
 …
 condition influences the relative vorticity and momentum diffusive trends, and is
 required in order to compute the vorticity at the coast. Four different types of
 lateral boundary condition are available, controlled by the value of the \np{rn_shlat}
+lateral boundary condition are available, controlled by the value of the \np{rn\_shlat}
 namelist parameter. (The value of the mask$_{f}$ array along the coastline is set
 equal to this parameter.) These are:
 …
 \begin{description}
 \item[free-slip boundary condition (\forcode{rn_shlat = 0}): ]  the tangential velocity at the
+\item[free-slip boundary condition (\np{rn\_shlat}\forcode{ = 0}): ]  the tangential velocity at the
 coastline is equal to the offshore velocity, $i.e.$ the normal derivative of the
 tangential velocity is zero at the coast, so the vorticity: mask$_{f}$ array is set
 to zero inside the land and just at the coast (Fig.~\ref{Fig_LBC_shlat}-a).
 \item[no-slip boundary condition (\forcode{rn_shlat = 2}): ] the tangential velocity vanishes
+\item[no-slip boundary condition (\np{rn\_shlat}\forcode{ = 2}): ] the tangential velocity vanishes
 at the coastline. Assuming that the tangential velocity decreases linearly from
 the closest ocean velocity grid point to the coastline, the normal derivative is
 …
 \end{equation}
 \item["partial" free-slip boundary condition (0$<$\np{rn_shlat}$<$2): ] the tangential
+\item["partial" free-slip boundary condition (0$<$\np{rn\_shlat}$<$2): ] the tangential
 velocity at the coastline is smaller than the offshore velocity, $i.e.$ there is a lateral
 friction but not strong enough to make the tangential velocity at the coast vanish
 …
 strictly inbetween $0$ and $2$.
 \item["strong" no-slip boundary condition (2$<$\np{rn_shlat}): ] the viscous boundary
+\item["strong" no-slip boundary condition (2$<$\np{rn\_shlat}): ] the viscous boundary
 layer is assumed to be smaller than half the grid size (Fig.~\ref{Fig_LBC_shlat}-d).
 The friction is thus larger than in the no-slip case.
 …
 % Boundary Condition around the Model Domain
 % ================================================================
 \section{Model Domain Boundary Condition (\protect\np{jperio})}
+\section{Model domain boundary condition (\protect\np{jperio})}
 \label{LBC_jperio}
 …
 % -------------------------------------------------------------------------------------------------------------
 %        Closed, cyclic, south symmetric (\np{jperio} = 0, 1 or 2)
+%        Closed, cyclic, south symmetric (\np{jperio}\forcode{ = 0..2})
 % -------------------------------------------------------------------------------------------------------------
 \subsection{Closed, cyclic, south symmetric (\protect\np{jperio} = 0, 1 or 2)}
+\subsection{Closed, cyclic, south symmetric (\protect\np{jperio}\forcode{= 0..2})}
 \label{LBC_jperio012}
 …
 \begin{description}
 \item[For closed boundary (\textit{jperio=0})], solid walls are imposed at all model
+\item[For closed boundary (\np{jperio}\forcode{ = 0})], solid walls are imposed at all model
 boundaries: first and last rows and columns are set to zero.
 \item[For cyclic east-west boundary (\textit{jperio=1})], first and last rows are set
+\item[For cyclic east-west boundary (\np{jperio}\forcode{ = 1})], first and last rows are set
 to zero (closed) whilst the first column is set to the value of the last-but-one column
 and the last column to the value of the second one (Fig.~\ref{Fig_LBC_jperio}-a).
 …
 cyclic cases.
 \item[For symmetric boundary condition across the equator (\textit{jperio=2})],
+\item[For symmetric boundary condition across the equator (\np{jperio}\forcode{ = 2})],
 last rows, and first and last columns are set to zero (closed). The row of symmetry
 is chosen to be the $u$- and $T-$points equator line ($j=2$, i.e. at the southern
 …
 %        North fold (\textit{jperio = 3 }to $6)$
 % -------------------------------------------------------------------------------------------------------------
 \subsection{North-fold (\textit{jperio = 3 }to $6$) }
+\subsection{North-fold (\protect\np{jperio}\forcode{ = 3..6})}
 \label{LBC_north_fold}
 …
 % Exchange with neighbouring processors
 % ====================================================================
+\section  [Exchange with neighbouring processors (\textit{lbclnk}, \textit{lib\_mpp})]
+      {Exchange with neighbouring processors (\protect\mdl{lbclnk}, \protect\mdl{lib\_mpp})}
+\section{Exchange with neighbouring processors (\protect\mdl{lbclnk}, \protect\mdl{lib\_mpp})}
 \label{LBC_mpp}
 …
 the model output files is undefined. Note that this is a problem for the meshmask file
 which requires to be defined over the whole domain. Therefore, user should not eliminate
 land processors when creating a meshmask file ($i.e.$ when setting a non-zero value to \np{nn_msh}).
+land processors when creating a meshmask file ($i.e.$ when setting a non-zero value to \np{nn\_msh}).
 %>>>>>>>>>>>>>>>>>>>>>>>>>>>>
 …
 % Unstructured open boundaries BDY
 % ====================================================================
 \section{Unstructured Open Boundary Conditions (BDY)}
+\section{Unstructured open boundary conditions (BDY)}
 \label{LBC_bdy}
 …
 %----------------------------------------------
 \subsection{The namelists}
+\subsection{Namelists}
 \label{BDY_namelist}
 The BDY module is activated by setting \np{ln_bdy} to true.
+The BDY module is activated by setting \np{ln\_bdy} to true.
 It is possible to define more than one boundary ``set'' and apply
 different boundary conditions to each set. The number of boundary
 sets is defined by \np{nb_bdy}.  Each boundary set may be defined
+sets is defined by \np{nb\_bdy}.  Each boundary set may be defined
 as a set of straight line segments in a namelist
 (\np{ln_coords_file}=.false.) or read in from a file
 (\np{ln_coords_file}=.true.). If the set is defined in a namelist,
+(\np{ln\_coords\_file}\forcode{ = .false.}) or read in from a file
+(\np{ln\_coords\_file}\forcode{ = .true.}). If the set is defined in a namelist,
 then the namelists nambdy\_index must be included separately, one for
 each set. If the set is defined by a file, then a
 …
 (``tra''). For each set of variables there is a choice of algorithm
 and a choice for the data, eg. for the active tracers the algorithm is
 set by \np{nn_tra} and the choice of data is set by
 \np{nn_tra_dta}.
+set by \np{nn\_tra} and the choice of data is set by
+\np{nn\_tra\_dta}.
 The choice of algorithm is currently as follows:
 …
 The main choice for the boundary data is
 to use initial conditions as boundary data (\forcode{nn_tra_dta = 0}) or to
 use external data from a file (\forcode{nn_tra_dta = 1}). For the
+to use initial conditions as boundary data (\np{nn\_tra\_dta}\forcode{ = 0}) or to
+use external data from a file (\np{nn\_tra\_dta}\forcode{ = 1}). For the
 barotropic solution there is also the option to use tidal
 harmonic forcing either by itself or in addition to other external
 …
 %----------------------------------------------
 \subsection{The Flow Relaxation Scheme}
+\subsection{Flow relaxation scheme}
 \label{BDY_FRS_scheme}
 …
 \end{equation}
 The width of the FRS zone is specified in the namelist as
 \np{nn_rimwidth}. This is typically set to a value between 8 and 10.
+\np{nn\_rimwidth}. This is typically set to a value between 8 and 10.
 %----------------------------------------------
 \subsection{The Flather radiation scheme}
+\subsection{Flather radiation scheme}
 \label{BDY_flather_scheme}
 …
 shelf break, then the areas of ocean outside of this boundary will
 need to be masked out. This can be done by reading a mask file defined
 as \np{cn_mask_file} in the nam\_bdy namelist. Only one mask file is
+as \np{cn\_mask\_file} in the nam\_bdy namelist. Only one mask file is
 used even if multiple boundary sets are defined.
 …
 There is an option to force the total volume in the regional model to be constant,
 similar to the option in the OBC module. This is controlled  by the \np{nn_volctl}
 parameter in the namelist. A value of \np{nn_volctl}~=~0 indicates that this option is not used.
 If  \np{nn_volctl}~=~1 then a correction is applied to the normal velocities
+similar to the option in the OBC module. This is controlled  by the \np{nn\_volctl}
+parameter in the namelist. A value of \np{nn\_volctl}\forcode{ = 0} indicates that this option is not used.
+If  \np{nn\_volctl}\forcode{ = 1} then a correction is applied to the normal velocities
 around the boundary at each timestep to ensure that the integrated volume flow
 through the boundary is zero. If \np{nn_volctl}~=~2 then the calculation of
+through the boundary is zero. If \np{nn\_volctl}\forcode{ = 2} then the calculation of
 the volume change on the timestep includes the change due to the freshwater
 flux across the surface and the correction velocity corrects for this as well.

branches/2017/dev_merge_2017/DOC/tex_sub/chap_LDF.tex

-                      r9392
+                      r9393
 Note that this chapter describes the standard implementation of iso-neutral
 tracer mixing, and Griffies's implementation, which is used if
 \forcode{traldf_grif = .true.}, is described in Appdx\ref{sec:triad}
+\np{traldf\_grif}\forcode{ = .true.}, is described in Appdx\ref{sec:triad}
 %-----------------------------------nam_traldf - nam_dynldf--------------------------------------------
 …
 % Direction of lateral Mixing
 % ================================================================
+\section  [Direction of Lateral Mixing (\textit{ldfslp})]
+      {Direction of Lateral Mixing (\protect\mdl{ldfslp})}
+\section{Direction of lateral mixing (\protect\mdl{ldfslp})}
 \label{LDF_slp}
 …
 A direction for lateral mixing has to be defined when the desired operator does
 not act along the model levels. This occurs when $(a)$ horizontal mixing is
 required on tracer or momentum (\np{ln_traldf_hor} or \np{ln_dynldf_hor})
+required on tracer or momentum (\np{ln\_traldf\_hor} or \np{ln\_dynldf\_hor})
 in $s$- or mixed $s$-$z$- coordinates, and $(b)$ isoneutral mixing is required
 whatever the vertical coordinate is. This direction of mixing is defined by its
 …
 %gm% add here afigure of the slope in i-direction
 \subsection{slopes for tracer geopotential mixing in the $s$-coordinate}
+\subsection{Slopes for tracer geopotential mixing in the $s$-coordinate}
 In $s$-coordinates, geopotential mixing ($i.e.$ horizontal mixing) $r_1$ and
 …
 %gm%  caution I'm not sure the simplification was a good idea!
+These slopes are computed once in \rou{ldfslp\_init} when \forcode{ln_sco = .true.}rue,
+and either \forcode{ln_traldf_hor = .true.}rue or \forcode{ln_dynldf_hor = .true.}rue.
+\subsection{Slopes for tracer iso-neutral mixing}\label{LDF_slp_iso}
+These slopes are computed once in \rou{ldfslp\_init} when \np{ln\_sco}\forcode{ = .true.}rue,
+and either \np{ln\_traldf\_hor}\forcode{ = .true.}rue or \np{ln\_dynldf\_hor}\forcode{ = .true.}rue.
+\subsection{Slopes for tracer iso-neutral mixing}
+\label{LDF_slp_iso}
 In iso-neutral mixing  $r_1$ and $r_2$ are the slopes between the iso-neutral
 and computational surfaces. Their formulation does not depend on the vertical
 …
 \item[$s$- or hybrid $s$-$z$- coordinate : ] in the current release of \NEMO,
 iso-neutral mixing is only employed for $s$-coordinates if the
 Griffies scheme is used (\forcode{traldf_grif = .true.}; see Appdx \ref{sec:triad}).
+Griffies scheme is used (\np{traldf\_grif}\forcode{ = .true.}; see Appdx \ref{sec:triad}).
 In other words, iso-neutral mixing will only be accurately represented with a
 linear equation of state (\forcode{nn_eos = 1} or 2). In the case of a "true" equation
+linear equation of state (\np{nn\_eos}\forcode{ = 1..2}). In the case of a "true" equation
 of state, the evaluation of $i$ and $j$ derivatives in \eqref{Eq_ldfslp_iso}
 will include a pressure dependent part, leading to the wrong evaluation of
 …
 ocean model are modified \citep{Weaver_Eby_JPO97,
   Griffies_al_JPO98}. Griffies's scheme is now available in \NEMO if
 \np{traldf_grif_iso} is set true; see Appdx \ref{sec:triad}. Here,
+\np{traldf\_grif\_iso} is set true; see Appdx \ref{sec:triad}. Here,
 another strategy is presented \citep{Lazar_PhD97}: a local
 filtering of the iso-neutral slopes (made on 9 grid-points) prevents
 …
 \colorbox{yellow}{add here a discussion about the flattening of the slopes, vs  tapering the coefficient.}
 \subsection{slopes for momentum iso-neutral mixing}
+\subsection{Slopes for momentum iso-neutral mixing}
 The iso-neutral diffusion operator on momentum is the same as the one used on
 …
 % Lateral Mixing Operator
 % ================================================================
+\section [Lateral Mixing Operators (\textit{ldftra}, \textit{ldfdyn})]
+        {Lateral Mixing Operators (\protect\mdl{traldf}, \protect\mdl{traldf}) }
+\section{Lateral mixing operators (\protect\mdl{traldf}, \protect\mdl{traldf}) }
 \label{LDF_op}
 …
 % Lateral Mixing Coefficients
 % ================================================================
+\section [Lateral Mixing Coefficient (\textit{ldftra}, \textit{ldfdyn})]
+        {Lateral Mixing Coefficient (\protect\mdl{ldftra}, \protect\mdl{ldfdyn}) }
+\section{Lateral mixing coefficient (\protect\mdl{ldftra}, \protect\mdl{ldfdyn}) }
 \label{LDF_coef}
 …
 as follows:
 \subsubsection{Constant Mixing Coefficients (default option)}
+\subsubsection{Constant mixing coefficients (default option)}
 When none of the \textbf{key\_dynldf\_...} and \textbf{key\_traldf\_...} keys are
 defined, a constant value is used over the whole ocean for momentum and
 tracers, which is specified through the \np{rn_ahm0} and \np{rn_aht0} namelist
+tracers, which is specified through the \np{rn\_ahm0} and \np{rn\_aht0} namelist
 parameters.
 \subsubsection{Vertically varying Mixing Coefficients (\protect\key{traldf\_c1d} and \key{dynldf\_c1d})}
+\subsubsection{Vertically varying mixing coefficients (\protect\key{traldf\_c1d} and \key{dynldf\_c1d})}
 The 1D option is only available when using the $z$-coordinate with full step.
 Indeed in all the other types of vertical coordinate, the depth is a 3D function
 …
 mixing coefficients will require 3D arrays. In the 1D option, a hyperbolic variation
 of the lateral mixing coefficient is introduced in which the surface value is
 \np{rn_aht0} (\np{rn_ahm0}), the bottom value is 1/4 of the surface value,
+\np{rn\_aht0} (\np{rn\_ahm0}), the bottom value is 1/4 of the surface value,
 and the transition takes place around z=300~m with a width of 300~m
 ($i.e.$ both the depth and the width of the inflection point are set to 300~m).
 This profile is hard coded in file \hf{traldf\_c1d}, but can be easily modified by users.
 \subsubsection{Horizontally Varying Mixing Coefficients (\protect\key{traldf\_c2d} and \protect\key{dynldf\_c2d})}
+\subsubsection{Horizontally varying mixing coefficients (\protect\key{traldf\_c2d} and \protect\key{dynldf\_c2d})}
 By default the horizontal variation of the eddy coefficient depends on the local mesh
 size and the type of operator used:
 …
 \end{equation}
 where $e_{max}$ is the maximum of $e_1$ and $e_2$ taken over the whole masked
 ocean domain, and $A_o^l$ is the \np{rn_ahm0} (momentum) or \np{rn_aht0} (tracer)
+ocean domain, and $A_o^l$ is the \np{rn\_ahm0} (momentum) or \np{rn\_aht0} (tracer)
 namelist parameter. This variation is intended to reflect the lesser need for subgrid
 scale eddy mixing where the grid size is smaller in the domain. It was introduced in
 …
 Other formulations can be introduced by the user for a given configuration.
 For example, in the ORCA2 global ocean model (see Configurations), the laplacian
 viscosity operator uses \np{rn_ahm0}~= 4.10$^4$ m$^2$/s poleward of 20$^{\circ}$
 north and south and decreases linearly to \np{rn_aht0}~= 2.10$^3$ m$^2$/s
+viscosity operator uses \np{rn\_ahm0}~= 4.10$^4$ m$^2$/s poleward of 20$^{\circ}$
+north and south and decreases linearly to \np{rn\_aht0}~= 2.10$^3$ m$^2$/s
 at the equator \citep{Madec_al_JPO96, Delecluse_Madec_Bk00}. This modification
 can be found in routine \rou{ldf\_dyn\_c2d\_orca} defined in \mdl{ldfdyn\_c2d}.
 …
 sub-domain options of ORCA2 and ORCA05 (see \&namcfg namelist).
 \subsubsection{Space Varying Mixing Coefficients (\protect\key{traldf\_c3d} and \key{dynldf\_c3d})}
+\subsubsection{Space varying mixing coefficients (\protect\key{traldf\_c3d} and \key{dynldf\_c3d})}
 The 3D space variation of the mixing coefficient is simply the combination of the
 …
 a grid size dependence of the magnitude of the coefficient.
 \subsubsection{Space and Time Varying Mixing Coefficients}
+\subsubsection{Space and time varying mixing coefficients}
 There is no default specification of space and time varying mixing coefficient.
 …
 (3) for isopycnal diffusion on momentum or tracers, an additional purely
 horizontal background diffusion with uniform coefficient can be added by
 setting a non zero value of \np{rn_ahmb0} or \np{rn_ahtb0}, a background horizontal
+setting a non zero value of \np{rn\_ahmb0} or \np{rn\_ahtb0}, a background horizontal
 eddy viscosity or diffusivity coefficient (namelist parameters whose default
 values are $0$). However, the technique used to compute the isopycnal
 …
 (6) it is possible to use both the laplacian and biharmonic operators concurrently.
 (7) it is possible to run without explicit lateral diffusion on momentum (\np{ln_dynldf_lap} =
 \np{ln_dynldf_bilap} = false). This is recommended when using the UBS advection
 scheme on momentum (\np{ln_dynadv_ubs} = true, see \ref{DYN_adv_ubs})
+(7) it is possible to run without explicit lateral diffusion on momentum (\np{ln\_dynldf\_lap}\forcode{ =
+}\np{ln\_dynldf\_bilap}\forcode{ = .false.}). This is recommended when using the UBS advection
+scheme on momentum (\np{ln\_dynadv\_ubs}\forcode{ = .true.}, see \ref{DYN_adv_ubs})
 and can be useful for testing purposes.
 …
 % Eddy Induced Mixing
 % ================================================================
+\section  [Eddy Induced Velocity (\textit{traadv\_eiv}, \textit{ldfeiv})]
+      {Eddy Induced Velocity (\protect\mdl{traadv\_eiv}, \protect\mdl{ldfeiv})}
+\section{Eddy induced velocity (\protect\mdl{traadv\_eiv}, \protect\mdl{ldfeiv})}
 \label{LDF_eiv}
 …
 described in \S\ref{LDF_coef}. If none of the keys \key{traldf\_cNd},
 N=1,2,3 is set (the default), spatially constant iso-neutral $A_l$ and
 GM diffusivity $A_e$ are directly set by \np{rn_aeih_0} and
 \np{rn_aeiv_0}. If 2D-varying coefficients are set with
+GM diffusivity $A_e$ are directly set by \np{rn\_aeih\_0} and
+\np{rn\_aeiv\_0}. If 2D-varying coefficients are set with
 \key{traldf\_c2d} then $A_l$ is reduced in proportion with horizontal
 scale factor according to \eqref{Eq_title} \footnote{Except in global ORCA
 …
   case, $A_e$ at low latitudes $|\theta|<20^{\circ}$ is further
   reduced by a factor $|f/f_{20}|$, where $f_{20}$ is the value of $f$
   at $20^{\circ}$~N} (\mdl{ldfeiv}) and \np{rn_aeiv_0} is ignored
+  at $20^{\circ}$~N} (\mdl{ldfeiv}) and \np{rn\_aeiv\_0} is ignored
 unless it is zero.
+}
 …
 \end{equation}
 where $A^{eiv}$ is the eddy induced velocity coefficient whose value is set
 through \np{rn_aeiv}, a \textit{nam\_traldf} namelist parameter.
+through \np{rn\_aeiv}, a \textit{nam\_traldf} namelist parameter.
 The three components of the eddy induced velocity are computed and add
 to the eulerian velocity in \mdl{traadv\_eiv}. This has been preferred to a

branches/2017/dev_merge_2017/DOC/tex_sub/chap_OBS.tex

-                      r9392
+                      r9393
 % Chapter observation operator (OBS)
 % ================================================================
 \chapter{Observation and model comparison (OBS)}
+\chapter{Observation and Model Comparison (OBS)}
 \label{OBS}
 …
 The OBS code is called from \mdl{nemogcm} for model initialisation and to calculate the model
 equivalent values for observations on the 0th timestep. The code is then called again after
 each timestep from \mdl{step}. The code is only activated if the namelist logical \np{ln_diaobs}
+each timestep from \mdl{step}. The code is only activated if the namelist logical \np{ln\_diaobs}
 is set to true.
 …
 Some profile observation types (e.g. tropical moored buoys) are made available as daily averaged quantities.
 The observation operator code can be set-up to calculate the equivalent daily average model temperature fields
 using the \np{nn_profdavtypes} namelist array. Some SST observations are equivalent to a night-time
+using the \np{nn\_profdavtypes} namelist array. Some SST observations are equivalent to a night-time
 average value and the observation operator code can calculate equivalent night-time average model SST fields by
 setting the namelist value \np{ln_sstnight} to true. Otherwise the model value from the nearest timestep to the
+setting the namelist value \np{ln\_sstnight} to true. Otherwise the model value from the nearest timestep to the
 observation time is used.
 …
 Options are defined through the  \ngn{namobs} namelist variables.
 The options \np{ln_t3d} and \np{ln_s3d} switch on the temperature and salinity
+The options \np{ln\_t3d} and \np{ln\_s3d} switch on the temperature and salinity
 profile observation operator code. The filename or array of filenames are
 specified using the \np{cn_profbfiles} variable. The model grid points for a
+specified using the \np{cn\_profbfiles} variable. The model grid points for a
 particular  observation latitude and longitude are found using the grid
 searching part of the code. This can be expensive, particularly for large
 numbers of observations, setting \np{ln_grid_search_lookup} allows the use of
+numbers of observations, setting \np{ln\_grid\_search\_lookup} allows the use of
 a lookup table which is saved into an ``xypos`` file (or files). This will need
 to be generated the first time if it does not exist in the run directory.
 However, once produced it will significantly speed up future grid searches.
 Setting \np{ln_grid_global} means that the code distributes the observations
+Setting \np{ln\_grid\_global} means that the code distributes the observations
 evenly between processors. Alternatively each processor will work with
 observations located within the model subdomain (see section~\ref{OBS_parallel}).
 …
 NEMO therefore has the capability to specify either an interpolation or an averaging (for surface observation types only).
 The main namelist option associated with the interpolation/averaging is \np{nn_2dint}. This default option can be set to values from 0 to 6.
+The main namelist option associated with the interpolation/averaging is \np{nn\_2dint}. This default option can be set to values from 0 to 6.
 Values between 0 to 4 are associated with interpolation while values 5 or 6 are associated with averaging.
 \begin{itemize}
 \item \forcode{nn_2dint = 0}: Distance-weighted interpolation
 \item \forcode{nn_2dint = 1}: Distance-weighted interpolation (small angle)
 \item \forcode{nn_2dint = 2}: Bilinear interpolation (geographical grid)
 \item \forcode{nn_2dint = 3}: Bilinear remapping interpolation (general grid)
 \item \forcode{nn_2dint = 4}: Polynomial interpolation
 \item \forcode{nn_2dint = 5}: Radial footprint averaging with diameter specified in the namelist as \np{rn\_???\_avglamscl} in degrees or metres (set using \np{ln\_???\_fp\_indegs})
 \item \forcode{nn_2dint = 6}: Rectangular footprint averaging with E/W and N/S size specified in the namelist as \np{rn\_???\_avglamscl} and \np{rn\_???\_avgphiscl} in degrees or metres (set using \np{ln\_???\_fp\_indegs})
+\item \np{nn\_2dint}\forcode{ = 0}: Distance-weighted interpolation
+\item \np{nn\_2dint}\forcode{ = 1}: Distance-weighted interpolation (small angle)
+\item \np{nn\_2dint}\forcode{ = 2}: Bilinear interpolation (geographical grid)
+\item \np{nn\_2dint}\forcode{ = 3}: Bilinear remapping interpolation (general grid)
+\item \np{nn\_2dint}\forcode{ = 4}: Polynomial interpolation
+\item \np{nn\_2dint}\forcode{ = 5}: Radial footprint averaging with diameter specified in the namelist as \np{rn\_???\_avglamscl} in degrees or metres (set using \np{ln\_???\_fp\_indegs})
+\item \np{nn\_2dint}\forcode{ = 6}: Rectangular footprint averaging with E/W and N/S size specified in the namelist as \np{rn\_???\_avglamscl} and \np{rn\_???\_avgphiscl} in degrees or metres (set using \np{ln\_???\_fp\_indegs})
 \end{itemize}
 The ??? in the last two options indicate these options should be specified for each observation type for which the averaging is to be performed (see namelist example above).
 The \np{nn_2dint} default option can be overridden for surface observation types using namelist values \np{nn\_2dint\_???} where ??? is one of sla,sst,sss,sic.
+The \np{nn\_2dint} default option can be overridden for surface observation types using namelist values \np{nn\_2dint\_???} where ??? is one of sla,sst,sss,sic.
 Below is some more detail on the various options for interpolation and averaging available in NEMO.
 …
 The above namelist will result in feedback files whose first 12 hours contain
 the first field of \ifile{foo} and the second 12 hours contain the second field.
+the first field of foo.nc and the second 12 hours contain the second field.
 %\begin{framed}
 …
 %\begin{framed}
 \textbf{Note: ln\_cl4} must be set to \emph{.TRUE.} in \textbf{namobs}
+\textbf{Note: ln\_cl4} must be set to \forcode{.true.} in \textbf{namobs}
 to use class 4 outputs.
 %\end{framed}
 …
 \noindent
 \linebreak
 \ifile{\textbf{\$\{prefix\}\_\$\{yyyymmdd\}\_\$\{sys\}\_\$\{cfg\}\_\$\{vn\}\_\$\{kind\}\_\$\{nproc\}}}
+\textbf{\$\{prefix\}\_\$\{yyyymmdd\}\_\$\{sys\}\_\$\{cfg\}\_\$\{vn\}\_\$\{kind\}\_\$\{nproc\}}.nc
 \noindent
 …
 \newpage
 \section{Observation Utilities}
+\section{Observation utilities}
 \label{OBS_obsutils}
 …
 \end{cmds}
 \subsection{building the obstools}
+\subsection{Building the obstools}
 To build the obstools use in the tools directory use ./maketools -n OBSTOOLS -m [ARCH].

branches/2017/dev_merge_2017/DOC/tex_sub/chap_SBC.tex

-                      r9392
+                      r9393
 Five different ways to provide the first six fields to the ocean are available which
 are controlled by namelist \ngn{namsbc} variables: an analytical formulation (\np{ln_ana}~=~true),
 a flux formulation (\np{ln_flx}~=~true), a bulk formulae formulation (CORE
 (\np{ln_blk_core}~=~true), CLIO (\np{ln_blk_clio}~=~true) or MFS
+are controlled by namelist \ngn{namsbc} variables: an analytical formulation (\np{ln\_ana}\forcode{ = .true.}),
+a flux formulation (\np{ln\_flx}\forcode{ = .true.}), a bulk formulae formulation (CORE
+(\np{ln\_blk\_core}\forcode{ = .true.}), CLIO (\np{ln\_blk\_clio}\forcode{ = .true.}) or MFS
 \footnote { Note that MFS bulk formulae compute fluxes only for the ocean component}
 (\np{ln_blk_mfs}~=~true) bulk formulae) and a coupled or mixed forced/coupled formulation
 (exchanges with a atmospheric model via the OASIS coupler) (\np{ln_cpl} or \np{ln_mixcpl}~=~true).
 When used ($i.e.$ \np{ln_apr_dyn}~=~true), the atmospheric pressure forces both ocean and ice dynamics.
 The frequency at which the forcing fields have to be updated is given by the \np{nn_fsbc} namelist parameter.
+(\np{ln\_blk\_mfs}\forcode{ = .true.}) bulk formulae) and a coupled or mixed forced/coupled formulation
+(exchanges with a atmospheric model via the OASIS coupler) (\np{ln\_cpl} or \np{ln\_mixcpl}\forcode{ = .true.}).
+When used ($i.e.$ \np{ln\_apr\_dyn}\forcode{ = .true.}), the atmospheric pressure forces both ocean and ice dynamics.
+The frequency at which the forcing fields have to be updated is given by the \np{nn\_fsbc} namelist parameter.
 When the fields are supplied from data files (flux and bulk formulations), the input fields
 need not be supplied on the model grid. Instead a file of coordinates and weights can
 …
 \item the rotation of vector components supplied relative to an east-north
 coordinate system onto the local grid directions in the model ;
 \item the addition of a surface restoring term to observed SST and/or SSS (\np{ln_ssr}~=~true) ;
 \item the modification of fluxes below ice-covered areas (using observed ice-cover or a sea-ice model) (\np{nn_ice}~=~0,1, 2 or 3) ;
 \item the addition of river runoffs as surface freshwater fluxes or lateral inflow (\np{ln_rnf}~=~true) ;
 \item the addition of isf melting as lateral inflow (parameterisation) or as fluxes applied at the land-ice ocean interface (\np{ln_isf}) ;
 \item the addition of a freshwater flux adjustment in order to avoid a mean sea-level drift (\np{nn_fwb}~=~0,~1~or~2) ;
 \item the transformation of the solar radiation (if provided as daily mean) into a diurnal cycle (\np{ln_dm2dc}~=~true) ;
 and a neutral drag coefficient can be read from an external wave model (\np{ln_cdgw}~=~true).
+\item the addition of a surface restoring term to observed SST and/or SSS (\np{ln\_ssr}\forcode{ = .true.}) ;
+\item the modification of fluxes below ice-covered areas (using observed ice-cover or a sea-ice model) (\np{nn\_ice}\forcode{ = 0..3}) ;
+\item the addition of river runoffs as surface freshwater fluxes or lateral inflow (\np{ln\_rnf}\forcode{ = .true.}) ;
+\item the addition of isf melting as lateral inflow (parameterisation) or as fluxes applied at the land-ice ocean interface (\np{ln\_isf}) ;
+\item the addition of a freshwater flux adjustment in order to avoid a mean sea-level drift (\np{nn\_fwb}\forcode{ = 0..2}) ;
+\item the transformation of the solar radiation (if provided as daily mean) into a diurnal cycle (\np{ln\_dm2dc}\forcode{ = .true.}) ;
+and a neutral drag coefficient can be read from an external wave model (\np{ln\_cdgw}\forcode{ = .true.}).
 \end{itemize}
 The latter option is possible only in case core or mfs bulk formulas are selected.
 …
 and \eqref{Eq_tra_sbc_lin} in \S\ref{TRA_sbc}).
 The latter is the penetrative part of the heat flux. It is applied as a 3D
 trends of the temperature equation (\mdl{traqsr} module) when \np{ln_traqsr}=\textit{true}.
+trends of the temperature equation (\mdl{traqsr} module) when \np{ln\_traqsr}\forcode{ = .true.}.
 The way the light penetrates inside the water column is generally a sum of decreasing
 exponentials (see \S\ref{TRA_qsr}).
 …
 %created!)
+%
 %Especially the \np{nn_fsbc}, the \mdl{sbc\_oce} module (fluxes + mean sst sss ssu
+%Especially the \np{nn\_fsbc}, the \mdl{sbc\_oce} module (fluxes + mean sst sss ssu
 %ssv) i.e. information required by flux computation or sea-ice
+%
 …
 The ocean model provides, at each time step, to the surface module (\mdl{sbcmod})
 the surface currents, temperature and salinity.
 These variables are averaged over \np{nn_fsbc} time-step (\ref{Tab_ssm}),
+These variables are averaged over \np{nn\_fsbc} time-step (\ref{Tab_ssm}),
 and it is these averaged fields which are used to computes the surface fluxes
 at a frequency of \np{nn_fsbc} time-step.
+at a frequency of \np{nn\_fsbc} time-step.
 …
 %       Input Data
 % ================================================================
 \section{Input Data generic interface}
+\section{Input data generic interface}
 \label{SBC_input}
 …
 Note that when an input data is archived on a disc which is accessible directly
 from the workspace where the code is executed, then the use can set the \np{cn_dir}
+from the workspace where the code is executed, then the use can set the \np{cn\_dir}
 to the pathway leading to the data. By default, the data are assumed to have been
 copied so that cn\_dir='./'.
 …
 % Input Data specification (\mdl{fldread})
 % -------------------------------------------------------------------------------------------------------------
 \subsection{Input Data specification (\protect\mdl{fldread})}
+\subsection{Input data specification (\protect\mdl{fldread})}
 \label{SBC_fldread}
 …
 \hline
                          & daily or weekLLL          & monthly                   &   yearly          \\   \hline
 clim = false   & \ifile{fn\_yYYYYmMMdDD}  &   \ifile{fn\_yYYYYmMM}   &   \ifile{fn\_yYYYY}  \\   \hline
 clim = true       & not possible                  &  \ifile{fn\_m??}             &   fn                \\   \hline
+\np{clim}\forcode{ = .false.} & fn\_yYYYYmMMdDD.nc  &   fn\_yYYYYmMM.nc   &   fn\_yYYYY.nc  \\   \hline
+\np{clim}\forcode{ = .true.}        & not possible                  &  fn\_m??.nc             &   fn                \\   \hline
 \end{tabular}
 \end{center}
 …
 a time interpolation will be performed at the following time: 0h30'00", 1h30'00", 2h30'00", etc.
 However, for forcing data related to the surface module, values are not needed at every
 time-step but at every \np{nn_fsbc} time-step. For example with \np{nn_fsbc}~=~3,
+time-step but at every \np{nn\_fsbc} time-step. For example with \np{nn\_fsbc}\forcode{ = 3},
 the surface module will be called at time-steps 1, 4, 7, etc. The date used for the time interpolation
 is thus redefined to be at the middle of \np{nn_fsbc} time-step period. In the previous example,
+is thus redefined to be at the middle of \np{nn\_fsbc} time-step period. In the previous example,
 this leads to: 1h30'00", 4h30'00", 7h30'00", etc. \\
 (2) For code readablility and maintenance issues, we don't take into account the NetCDF input file
 …
 % Interpolation on the Fly
 % -------------------------------------------------------------------------------------------------------------
 \subsection [Interpolation on-the-Fly] {Interpolation on-the-Fly}
+\subsection{Interpolation on-the-fly}
 \label{SBC_iof}
 …
 Note that nn\_lsm=0 forces the code to not apply the procedure even if a file for land/sea mask is supplied.
 \subsubsection{Bilinear Interpolation}
+\subsubsection{Bilinear interpolation}
 \label{SBC_iof_bilinear}
 …
 and wgt(1) corresponds to variable "wgt01" for example.
 \subsubsection{Bicubic Interpolation}
+\subsubsection{Bicubic interpolation}
 \label{SBC_iof_bicubic}
 …
 % Standalone Surface Boundary Condition Scheme
 % -------------------------------------------------------------------------------------------------------------
 \subsection [Standalone Surface Boundary Condition Scheme] {Standalone Surface Boundary Condition Scheme}
+\subsection{Standalone surface boundary condition scheme}
 \label{SAS_iof}
 …
 \item  Development of sea-ice algorithms or parameterizations.
 \item  spinup of the iceberg floats
 \item  ocean/sea-ice simulation with both media running in parallel (\np{ln_mixcpl}~=~\textit{true})
+\item  ocean/sea-ice simulation with both media running in parallel (\np{ln\_mixcpl}\forcode{ = .true.})
 \end{itemize}
 …
 % Analytical formulation (sbcana module)
 % ================================================================
+\section  [Analytical formulation (\textit{sbcana}) ]
+      {Analytical formulation (\protect\mdl{sbcana} module) }
+\section{Analytical formulation (\protect\mdl{sbcana})}
 \label{SBC_ana}
 …
 In this case, all the six fluxes needed by the ocean are assumed to
 be uniform in space. They take constant values given in the namelist
 \ngn{namsbc{\_}ana} by the variables \np{rn_utau0}, \np{rn_vtau0}, \np{rn_qns0},
 \np{rn_qsr0}, and \np{rn_emp0} ($\textit{emp}=\textit{emp}_S$). The runoff is set to zero.
+\ngn{namsbc{\_}ana} by the variables \np{rn\_utau0}, \np{rn\_vtau0}, \np{rn\_qns0},
+\np{rn\_qsr0}, and \np{rn\_emp0} ($\textit{emp}=\textit{emp}_S$). The runoff is set to zero.
 In addition, the wind is allowed to reach its nominal value within a given number
 of time steps (\np{nn_tau000}).
+of time steps (\np{nn\_tau000}).
 If a user wants to apply a different analytical forcing, the \mdl{sbcana}
 …
 % Flux formulation
 % ================================================================
+\section  [Flux formulation (\textit{sbcflx}) ]
+      {Flux formulation (\protect\mdl{sbcflx} module) }
+\section{Flux formulation (\protect\mdl{sbcflx})}
 \label{SBC_flx}
 %------------------------------------------namsbc_flx----------------------------------------------------
 …
 %-------------------------------------------------------------------------------------------------------------
 In the flux formulation (\forcode{ln_flx = .true.}), the surface boundary
+In the flux formulation (\np{ln\_flx}\forcode{ = .true.}), the surface boundary
 condition fields are directly read from input files. The user has to define
 in the namelist \ngn{namsbc{\_}flx} the name of the file, the name of the variable
 …
 % Bulk formulation
 % ================================================================
 \section  [Bulk formulation (\textit{sbcblk\_core}, \textit{sbcblk\_clio} or \textit{sbcblk\_mfs}) ]
       {Bulk formulation \small{(\protect\mdl{sbcblk\_core} \protect\mdl{sbcblk\_clio} \protect\mdl{sbcblk\_mfs} modules)} }
+\section[Bulk formulation {(\textit{sbcblk\{\_core,\_clio,\_mfs\}.F90})}]
+         {Bulk formulation {(\protect\mdl{sbcblk\_core}, \protect\mdl{sbcblk\_clio}, \protect\mdl{sbcblk\_mfs})}}
 \label{SBC_blk}
 …
 The atmospheric fields used depend on the bulk formulae used. Three bulk formulations
 are available : the CORE, the CLIO and the MFS bulk formulea. The choice is made by setting to true
 one of the following namelist variable : \np{ln_core} ; \np{ln_clio} or  \np{ln_mfs}.
+one of the following namelist variable : \np{ln\_core} ; \np{ln\_clio} or  \np{ln\_mfs}.
 Note : in forced mode, when a sea-ice model is used, a bulk formulation (CLIO or CORE) have to be used.
 …
 %        CORE Bulk formulea
 % -------------------------------------------------------------------------------------------------------------
+\subsection    [CORE Bulk formulea (\protect\forcode{ln_core = .true.})]
+            {CORE Bulk formulea (\protect\forcode{ln_core = .true.}, \protect\mdl{sbcblk\_core})}
+\subsection{CORE formulea (\protect\mdl{sbcblk\_core}, \protect\np{ln\_core}\forcode{ = .true.})}
 \label{SBC_blk_core}
 %------------------------------------------namsbc_core----------------------------------------------------
 …
 or larger than the one of the input atmospheric fields.
 The \np{sn_wndi}, \np{sn_wndj}, \np{sn_qsr}, \np{sn_qlw}, \np{sn_tair}, \np{sn_humi},
 \np{sn_prec}, \np{sn_snow}, \np{sn_tdif} parameters describe the fields
+The \np{sn\_wndi}, \np{sn\_wndj}, \np{sn\_qsr}, \np{sn\_qlw}, \np{sn\_tair}, \np{sn\_humi},
+\np{sn\_prec}, \np{sn\_snow}, \np{sn\_tdif} parameters describe the fields
 and the way they have to be used (spatial and temporal interpolations).
 \np{cn_dir} is the directory of location of bulk files
 \np{ln_taudif} is the flag to specify if we use Hight Frequency (HF) tau information (.true.) or not (.false.)
 \np{rn_zqt}: is the height of humidity and temperature measurements (m)
 \np{rn_zu}: is the height of wind measurements (m)
+\np{cn\_dir} is the directory of location of bulk files
+\np{ln\_taudif} is the flag to specify if we use Hight Frequency (HF) tau information (.true.) or not (.false.)
+\np{rn\_zqt}: is the height of humidity and temperature measurements (m)
+\np{rn\_zu}: is the height of wind measurements (m)
 Three multiplicative factors are availables :
 \np{rn_pfac} and \np{rn_efac} allows to adjust (if necessary) the global freshwater budget
+\np{rn\_pfac} and \np{rn\_efac} allows to adjust (if necessary) the global freshwater budget
 by increasing/reducing the precipitations (total and snow) and or evaporation, respectively.
 The third one,\np{rn_vfac}, control to which extend the ice/ocean velocities are taken into account
+The third one,\np{rn\_vfac}, control to which extend the ice/ocean velocities are taken into account
 in the calculation of surface wind stress. Its range should be between zero and one,
 and it is recommended to set it to 0.
 …
 %        CLIO Bulk formulea
 % -------------------------------------------------------------------------------------------------------------
+\subsection    [CLIO Bulk formulea (\protect\forcode{ln_clio = .true.})]
+            {CLIO Bulk formulea (\protect\forcode{ln_clio = .true.}, \protect\mdl{sbcblk\_clio})}
+\subsection{CLIO formulea (\protect\mdl{sbcblk\_clio}, \protect\np{ln\_clio}\forcode{ = .true.})}
 \label{SBC_blk_clio}
 %------------------------------------------namsbc_clio----------------------------------------------------
 …
 %        MFS Bulk formulae
 % -------------------------------------------------------------------------------------------------------------
+\subsection    [MFS Bulk formulea (\protect\forcode{ln_mfs = .true.})]
+            {MFS Bulk formulea (\protect\forcode{ln_mfs = .true.}, \protect\mdl{sbcblk\_mfs})}
+\subsection{MFS formulea (\protect\mdl{sbcblk\_mfs}, \protect\np{ln\_mfs}\forcode{ = .true.})}
 \label{SBC_blk_mfs}
 %------------------------------------------namsbc_mfs----------------------------------------------------
 …
 The required 7 input fields must be provided on the model Grid-T and  are:
 \begin{itemize}
 \item          Zonal Component of the 10m wind ($ms^{-1}$)  (\np{sn_windi})
 \item          Meridional Component of the 10m wind ($ms^{-1}$)  (\np{sn_windj})
 \item          Total Claud Cover (\%)  (\np{sn_clc})
 \item          2m Air Temperature ($K$) (\np{sn_tair})
 \item          2m Dew Point Temperature ($K$)  (\np{sn_rhm})
 \item          Total Precipitation ${Kg} m^{-2} s^{-1}$ (\np{sn_prec})
 \item          Mean Sea Level Pressure (${Pa}$) (\np{sn_msl})
+\item          Zonal Component of the 10m wind ($ms^{-1}$)  (\np{sn\_windi})
+\item          Meridional Component of the 10m wind ($ms^{-1}$)  (\np{sn\_windj})
+\item          Total Claud Cover (\%)  (\np{sn\_clc})
+\item          2m Air Temperature ($K$) (\np{sn\_tair})
+\item          2m Dew Point Temperature ($K$)  (\np{sn\_rhm})
+\item          Total Precipitation ${Kg} m^{-2} s^{-1}$ (\np{sn\_prec})
+\item          Mean Sea Level Pressure (${Pa}$) (\np{sn\_msl})
 \end{itemize}
 % -------------------------------------------------------------------------------------------------------------
 …
 % Coupled formulation
 % ================================================================
+\section  [Coupled formulation (\textit{sbccpl}) ]
+      {Coupled formulation (\protect\mdl{sbccpl} module)}
+\section{Coupled formulation (\protect\mdl{sbccpl})}
 \label{SBC_cpl}
 %------------------------------------------namsbc_cpl----------------------------------------------------
 …
 as well as to \href{http://wrf-model.org/}{WRF} (Weather Research and Forecasting Model).
 Note that in addition to the setting of \np{ln_cpl} to true, the \key{coupled} have to be defined.
+Note that in addition to the setting of \np{ln\_cpl} to true, the \key{coupled} have to be defined.
 The CPP key is mainly used in sea-ice to ensure that the atmospheric fluxes are
 actually recieved by the ice-ocean system (no calculation of ice sublimation in coupled mode).
 …
 %        Atmospheric pressure
 % ================================================================
+\section   [Atmospheric pressure (\textit{sbcapr})]
+         {Atmospheric pressure (\protect\mdl{sbcapr})}
+\section{Atmospheric pressure (\protect\mdl{sbcapr})}
 \label{SBC_apr}
 %------------------------------------------namsbc_apr----------------------------------------------------
 …
 The optional atmospheric pressure can be used to force ocean and ice dynamics
 (\np{ln_apr_dyn}~=~true, \textit{\ngn{namsbc}} namelist ).
 The input atmospheric forcing defined via \np{sn_apr} structure (\textit{namsbc\_apr} namelist)
+(\np{ln\_apr\_dyn}\forcode{ = .true.}, \textit{\ngn{namsbc}} namelist ).
+The input atmospheric forcing defined via \np{sn\_apr} structure (\textit{namsbc\_apr} namelist)
 can be interpolated in time to the model time step, and even in space when the
 interpolation on-the-fly is used. When used to force the dynamics, the atmospheric
 …
 \end{equation}
 where $P_{atm}$ is the atmospheric pressure and $P_o$ a reference atmospheric pressure.
 A value of $101,000~N/m^2$ is used unless \np{ln_ref_apr} is set to true. In this case $P_o$
+A value of $101,000~N/m^2$ is used unless \np{ln\_ref\_apr} is set to true. In this case $P_o$
 is set to the value of $P_{atm}$ averaged over the ocean domain, $i.e.$ the mean value of
 $\eta_{ib}$ is kept to zero at all time step.
 …
 When using time-splitting and BDY package for open boundaries conditions, the equivalent
 inverse barometer sea surface height $\eta_{ib}$ can be added to BDY ssh data:
 \np{ln_apr_obc}  might be set to true.
+\np{ln\_apr\_obc}  might be set to true.
 % ================================================================
 %        Tidal Potential
 % ================================================================
+\section   [Tidal Potential (\textit{sbctide})]
+                        {Tidal Potential (\protect\mdl{sbctide})}
+\section{Tidal potential (\protect\mdl{sbctide})}
 \label{SBC_tide}
 …
 A module is available to compute the tidal potential and use it in the momentum equation.
 This option is activated when \np{ln_tide} is set to true in \ngn{nam\_tide}.
+This option is activated when \np{ln\_tide} is set to true in \ngn{nam\_tide}.
 Some parameters are available in namelist \ngn{nam\_tide}:
 - \np{ln_tide_load} activate the load potential forcing and \np{filetide_load} is  the associated file
 - \np{ln_tide_pot} activate the tidal potential forcing
 - \np{nb_harmo} is the number of constituent used
+- \np{ln\_tide\_load} activate the load potential forcing and \np{filetide\_load} is  the associated file
+- \np{ln\_tide\_pot} activate the tidal potential forcing
+- \np{nb\_harmo} is the number of constituent used
 - \np{clname} is the name of constituent
 …
 %        River runoffs
 % ================================================================
+\section   [River runoffs (\textit{sbcrnf})]
+         {River runoffs (\protect\mdl{sbcrnf})}
+\section{River runoffs (\protect\mdl{sbcrnf})}
 \label{SBC_rnf}
 %------------------------------------------namsbc_rnf----------------------------------------------------
 …
 depth (in metres) which the river should be added to.
 Namelist variables in \ngn{namsbc\_rnf}, \np{ln_rnf_depth}, \np{ln_rnf_sal} and \np{ln_rnf_temp} control whether
+Namelist variables in \ngn{namsbc\_rnf}, \np{ln\_rnf\_depth}, \np{ln\_rnf\_sal} and \np{ln\_rnf\_temp} control whether
 the river attributes (depth, salinity and temperature) are read in and used.  If these are set
 as false the river is added to the surface box only, assumed to be fresh (0~psu), and/or
 …
 to give the heat and salt content of the river runoff.
 After the user specified depth is read ini, the number of grid boxes this corresponds to is
 calculated and stored in the variable \np{nz_rnf}.
+calculated and stored in the variable \np{nz\_rnf}.
 The variable \textit{h\_dep} is then calculated to be the depth (in metres) of the bottom of the
 lowest box the river water is being added to (i.e. the total depth that river water is being added to in the model).
 …
 %        Ice shelf melting
 % ================================================================
+\section   [Ice shelf melting (\textit{sbcisf})]
+                        {Ice shelf melting (\protect\mdl{sbcisf})}
+\section{Ice shelf melting (\protect\mdl{sbcisf})}
 \label{SBC_isf}
 %------------------------------------------namsbc_isf----------------------------------------------------
 \forfile{../namelists/namsbc_isf}
 %--------------------------------------------------------------------------------------------------------
 Namelist variable in \ngn{namsbc}, \np{nn_isf}, controls the ice shelf representation used.
+Namelist variable in \ngn{namsbc}, \np{nn\_isf}, controls the ice shelf representation used.
 \begin{description}
 \item[\np{nn_isf}~=~1]
 The ice shelf cavity is represented (\np{ln_isfcav}~=~true needed). The fwf and heat flux are computed.
+\item[\np{nn\_isf}\forcode{ = 1}]
+The ice shelf cavity is represented (\np{ln\_isfcav}\forcode{ = .true.} needed). The fwf and heat flux are computed.
 Two different bulk formula are available:
    \begin{description}
    \item[\np{nn_isfblk}~=~1]
+   \item[\np{nn\_isfblk}\forcode{ = 1}]
    The bulk formula used to compute the melt is based the one described in \citet{Hunter2006}.
         This formulation is based on a balance between the upward ocean heat flux and the latent heat flux at the ice shelf base.
    \item[\np{nn_isfblk}~=~2]
+   \item[\np{nn\_isfblk}\forcode{ = 2}]
    The bulk formula used to compute the melt is based the one described in \citet{Jenkins1991}.
         This formulation is based on a 3 equations formulation (a heat flux budget, a salt flux budget
 …
 For this 2 bulk formulations, there are 3 different ways to compute the exchange coeficient:
    \begin{description}
         \item[\np{nn\_gammablk~=~0~}]
    The salt and heat exchange coefficients are constant and defined by \np{rn_gammas0} and \np{rn_gammat0}
    \item[\np{nn\_gammablk~=~1~}]
    The salt and heat exchange coefficients are velocity dependent and defined as $rn\_gammas0 \times u_{*}$ and $rn\_gammat0 \times u_{*}$
         where $u_{*}$ is the friction velocity in the top boundary layer (ie first \np{rn_hisf_tbl} meters).
+        \item[\np{nn\_gammablk}\forcode{ = 0}]
+   The salt and heat exchange coefficients are constant and defined by \np{rn\_gammas0} and \np{rn\_gammat0}
+   \item[\np{nn\_gammablk}\forcode{ = 1}]
+   The salt and heat exchange coefficients are velocity dependent and defined as \np{rn\_gammas0}$ \times u_{*}$ and \np{rn\_gammat0}$ \times u_{*}$
+        where $u_{*}$ is the friction velocity in the top boundary layer (ie first \np{rn\_hisf\_tbl} meters).
         See \citet{Jenkins2010} for all the details on this formulation.
    \item[\np{nn\_gammablk~=~2~}]
+   \item[\np{nn\_gammablk}\forcode{ = 2}]
    The salt and heat exchange coefficients are velocity and stability dependent and defined as
         $\gamma_{T,S} = \frac{u_{*}}{\Gamma_{Turb} + \Gamma^{T,S}_{Mole}}$
         where $u_{*}$ is the friction velocity in the top boundary layer (ie first \np{rn_hisf_tbl} meters),
+        where $u_{*}$ is the friction velocity in the top boundary layer (ie first \np{rn\_hisf\_tbl} meters),
         $\Gamma_{Turb}$ the contribution of the ocean stability and
         $\Gamma^{T,S}_{Mole}$ the contribution of the molecular diffusion.
 …
         \end{description}
 \item[\np{nn_isf}~=~2]
+\item[\np{nn\_isf}\forcode{ = 2}]
 A parameterisation of isf is used. The ice shelf cavity is not represented.
 The fwf is distributed along the ice shelf edge between the depth of the average grounding line (GL)
 (\np{sn_depmax_isf}) and the base of the ice shelf along the calving front (\np{sn_depmin_isf}) as in (\np{nn_isf}~=~3).
+(\np{sn\_depmax\_isf}) and the base of the ice shelf along the calving front (\np{sn\_depmin\_isf}) as in (\np{nn\_isf}\forcode{ = 3}).
 Furthermore the fwf and heat flux are computed using the \citet{Beckmann2003} parameterisation of isf melting.
 The effective melting length (\np{sn_Leff_isf}) is read from a file.
 \item[\np{nn_isf}~=~3]
+The effective melting length (\np{sn\_Leff\_isf}) is read from a file.
+\item[\np{nn\_isf}\forcode{ = 3}]
 A simple parameterisation of isf is used. The ice shelf cavity is not represented.
 The fwf (\np{sn_rnfisf}) is prescribed and distributed along the ice shelf edge between the depth of the average grounding line (GL)
 (\np{sn_depmax_isf}) and the base of the ice shelf along the calving front (\np{sn_depmin_isf}).
+The fwf (\np{sn\_rnfisf}) is prescribed and distributed along the ice shelf edge between the depth of the average grounding line (GL)
+(\np{sn\_depmax\_isf}) and the base of the ice shelf along the calving front (\np{sn\_depmin\_isf}).
 The heat flux ($Q_h$) is computed as $Q_h = fwf \times L_f$.
 \item[\np{nn_isf}~=~4]
 The ice shelf cavity is opened (\np{ln_isfcav}~=~true needed). However, the fwf is not computed but specified from file \np{sn_fwfisf}).
+\item[\np{nn\_isf}\forcode{ = 4}]
+The ice shelf cavity is opened (\np{ln\_isfcav}\forcode{ = .true.} needed). However, the fwf is not computed but specified from file \np{sn\_fwfisf}).
 The heat flux ($Q_h$) is computed as $Q_h = fwf \times L_f$.\\
 \end{description}
 $\bullet$ \np{nn_isf}~=~1 and \np{nn_isf}~=~2 compute a melt rate based on the water mass properties, ocean velocities and depth.
+$\bullet$ \np{nn\_isf}\forcode{ = 1} and \np{nn\_isf}\forcode{ = 2} compute a melt rate based on the water mass properties, ocean velocities and depth.
  This flux is thus highly dependent of the model resolution (horizontal and vertical), realism of the water masses onto the shelf ...\\
 $\bullet$ \np{nn_isf}~=~3 and \np{nn_isf}~=~4 read the melt rate from a file. You have total control of the fwf forcing.
+$\bullet$ \np{nn\_isf}\forcode{ = 3} and \np{nn\_isf}\forcode{ = 4} read the melt rate from a file. You have total control of the fwf forcing.
 This can be usefull if the water masses on the shelf are not realistic or the resolution (horizontal/vertical) are too
 coarse to have realistic melting or for studies where you need to control your heat and fw input.\\
 A namelist parameters control over how many meters the heat and fw fluxes are spread.
 \np{rn_hisf_tbl}] is the top boundary layer thickness as defined in \citet{Losch2008}.
 This parameter is only used if \np{nn_isf}~=~1 or \np{nn_isf}~=~4
 If \np{rn_hisf_tbl} = 0., the fluxes are put in the top level whatever is its tickness.
 If \np{rn_hisf_tbl} $>$ 0., the fluxes are spread over the first \np{rn_hisf_tbl} m (ie over one or several cells).\\
+\np{rn\_hisf\_tbl}] is the top boundary layer thickness as defined in \citet{Losch2008}.
+This parameter is only used if \np{nn\_isf}\forcode{ = 1} or \np{nn\_isf}\forcode{ = 4}
+If \np{rn\_hisf\_tbl}\forcode{ = 0}., the fluxes are put in the top level whatever is its tickness.
+If \np{rn\_hisf\_tbl} $>$ 0., the fluxes are spread over the first \np{rn\_hisf\_tbl} m (ie over one or several cells).\\
 The ice shelf melt is implemented as a volume flux with in the same way as for the runoff.
 …
 \section{ Ice sheet coupling}
+\section{Ice sheet coupling}
 \label{SBC_iscpl}
 %------------------------------------------namsbc_iscpl----------------------------------------------------
 …
 Ice sheet/ocean coupling is done through file exchange at the restart step. NEMO, at each restart step,
 read the bathymetry and ice shelf draft variable in a netcdf file.
 If \np{ln\_iscpl = ~true}, the isf draft is assume to be different at each restart step
+If \np{ln\_iscpl}\forcode{ = .true.}, the isf draft is assume to be different at each restart step
 with potentially some new wet/dry cells due to the ice sheet dynamics/thermodynamics.
 The wetting and drying scheme applied on the restart is very simple and described below for the 6 different cases:
 …
    set mask to 1, T/S is extrapolated from neighbours, ssh is extrapolated from neighbours and U/V set to 0. If no neighbour, T/S/U/V and mask set to 0.
 \end{description}
 The extrapolation is call \np{nn_drown} times. It means that if the grounding line retreat by more than \np{nn_drown} cells between 2 coupling steps,
+The extrapolation is call \np{nn\_drown} times. It means that if the grounding line retreat by more than \np{nn\_drown} cells between 2 coupling steps,
  the code will be unable to fill all the new wet cells properly. The default number is set up for the MISOMIP idealised experiments.\\
 This coupling procedure is able to take into account grounding line and calving front migration. However, it is a non-conservative processe.
 This could lead to a trend in heat/salt content and volume. In order to remove the trend and keep the conservation level as close to 0 as possible,
  a simple conservation scheme is available with \np{ln\_hsb = ~true}. The heat/salt/vol. gain/loss is diagnose, as well as the location.
+ a simple conservation scheme is available with \np{ln\_hsb}\forcode{ = .true.}. The heat/salt/vol. gain/loss is diagnose, as well as the location.
 Based on what is done on sbcrnf to prescribed a source of heat/salt/vol., the heat/salt/vol. gain/loss is removed/added,
  over a period of \np{rn_fiscpl} time step, into the system.
 So after \np{rn_fiscpl} time step, all the heat/salt/vol. gain/loss due to extrapolation process is canceled.\\
+ over a period of \np{rn\_fiscpl} time step, into the system.
+So after \np{rn\_fiscpl} time step, all the heat/salt/vol. gain/loss due to extrapolation process is canceled.\\
 As the before and now fields are not compatible (modification of the geometry), the restart time step is prescribed to be an euler time step instead of a leap frog and $fields_b = fields_n$.
 …
 Icebergs are initially spawned into one of ten classes which have specific mass and thickness as described
 in the \ngn{namberg} namelist:
 \np{rn_initial_mass} and \np{rn_initial_thickness}.
 Each class has an associated scaling (\np{rn_mass_scaling}), which is an integer representing how many icebergs
+\np{rn\_initial\_mass} and \np{rn\_initial\_thickness}.
+Each class has an associated scaling (\np{rn\_mass\_scaling}), which is an integer representing how many icebergs
 of this class are being described as one lagrangian point (this reduces the numerical problem of tracking every single iceberg).
 They are enabled by setting \np{ln_icebergs}~=~true.
+They are enabled by setting \np{ln\_icebergs}\forcode{ = .true.}.
 Two initialisation schemes are possible.
 \begin{description}
 \item[\np{nn_test_icebergs}~$>$~0]
 In this scheme, the value of \np{nn_test_icebergs} represents the class of iceberg to generate
 (so between 1 and 10), and \np{nn_test_icebergs} provides a lon/lat box in the domain at each
+\item[\np{nn\_test\_icebergs}~$>$~0]
+In this scheme, the value of \np{nn\_test\_icebergs} represents the class of iceberg to generate
+(so between 1 and 10), and \np{nn\_test\_icebergs} provides a lon/lat box in the domain at each
 grid point of which an iceberg is generated at the beginning of the run.
 (Note that this happens each time the timestep equals \np{nn_nit000}.)
 \np{nn_test_icebergs} is defined by four numbers in \np{nn_test_box} representing the corners
+(Note that this happens each time the timestep equals \np{nn\_nit000}.)
+\np{nn\_test\_icebergs} is defined by four numbers in \np{nn\_test\_box} representing the corners
 of the geographical box: lonmin,lonmax,latmin,latmax
 \item[\np{nn_test_icebergs}~=~-1]
 In this scheme the model reads a calving file supplied in the \np{sn_icb} parameter.
+\item[\np{nn\_test\_icebergs}\forcode{ = -1}]
+In this scheme the model reads a calving file supplied in the \np{sn\_icb} parameter.
 This should be a file with a field on the configuration grid (typically ORCA) representing ice accumulation rate at each model point.
 These should be ocean points adjacent to land where icebergs are known to calve.
 …
 Icebergs are influenced by wind, waves and currents, bottom melt and erosion.
 The latter act to disintegrate the iceberg. This is either all melted freshwater, or
 (if \np{rn_bits_erosion_fraction}~$>$~0) into melt and additionally small ice bits
+(if \np{rn\_bits\_erosion\_fraction}~$>$~0) into melt and additionally small ice bits
 which are assumed to propagate with their larger parent and thus delay fluxing into the ocean.
 Melt water (and other variables on the configuration grid) are written into the main NEMO model output files.
 …
 Extensive diagnostics can be produced.
 Separate output files are maintained for human-readable iceberg information.
 A separate file is produced for each processor (independent of \np{ln_ctl}).
+A separate file is produced for each processor (independent of \np{ln\_ctl}).
 The amount of information is controlled by two integer parameters:
 \begin{description}
 \item[\np{nn_verbose_level}]  takes a value between one and four and represents
+\item[\np{nn\_verbose\_level}]  takes a value between one and four and represents
 an increasing number of points in the code at which variables are written, and an
 increasing level of obscurity.
 \item[\np{nn_verbose_write}] is the number of timesteps between writes
+\item[\np{nn\_verbose\_write}] is the number of timesteps between writes
 \end{description}
 Iceberg trajectories can also be written out and this is enabled by setting \np{nn_sample_rate}~$>$~0.
+Iceberg trajectories can also be written out and this is enabled by setting \np{nn\_sample\_rate}~$>$~0.
 A non-zero value represents how many timesteps between writes of information into the output file.
 These output files are in NETCDF format.
 …
 %        Diurnal cycle
 % -------------------------------------------------------------------------------------------------------------
+\subsection   [Diurnal  cycle (\textit{sbcdcy})]
+         {Diurnal cycle (\protect\mdl{sbcdcy})}
+\subsection{Diurnal cycle (\protect\mdl{sbcdcy})}
 \label{SBC_dcy}
 %------------------------------------------namsbc_rnf----------------------------------------------------
 …
 the diurnal cycle of SWF is a scaling of the top of the atmosphere diurnal cycle
 of incident SWF. The \cite{Bernie_al_CD07} reconstruction algorithm is available
 in \NEMO by setting \np{ln_dm2dc}~=~true (a \textit{\ngn{namsbc}} namelist variable) when using
 CORE bulk formulea (\np{ln_blk_core}~=~true) or the flux formulation (\np{ln_flx}~=~true).
+in \NEMO by setting \np{ln\_dm2dc}\forcode{ = .true.} (a \textit{\ngn{namsbc}} namelist variable) when using
+CORE bulk formulea (\np{ln\_blk\_core}\forcode{ = .true.}) or the flux formulation (\np{ln\_flx}\forcode{ = .true.}).
 The reconstruction is performed in the \mdl{sbcdcy} module. The detail of the algoritm used
 can be found in the appendix~A of \cite{Bernie_al_CD07}. The algorithm preserve the daily
 …
 of the analytical cycle over this time step (Fig.\ref{Fig_SBC_diurnal}).
 The use of diurnal cycle reconstruction requires the input SWF to be daily
 ($i.e.$ a frequency of 24 and a time interpolation set to true in \np{sn_qsr} namelist parameter).
+($i.e.$ a frequency of 24 and a time interpolation set to true in \np{sn\_qsr} namelist parameter).
 Furthermore, it is recommended to have a least 8 surface module time step per day,
 that is  $\rdt \ nn\_fsbc < 10,800~s = 3~h$. An example of recontructed SWF
 …
 \label{SBC_rotation}
 When using a flux (\forcode{ln_flx = .true.}) or bulk (\forcode{ln_clio = .true.} or \forcode{ln_core = .true.}) formulation,
+When using a flux (\np{ln\_flx}\forcode{ = .true.}) or bulk (\np{ln\_clio}\forcode{ = .true.} or \np{ln\_core}\forcode{ = .true.}) formulation,
 pairs of vector components can be rotated from east-north directions onto the local grid directions.
 This is particularly useful when interpolation on the fly is used since here any vectors are likely to be defined
 …
 %        Surface restoring to observed SST and/or SSS
 % -------------------------------------------------------------------------------------------------------------
+\subsection    [Surface restoring to observed SST and/or SSS (\textit{sbcssr})]
+         {Surface restoring to observed SST and/or SSS (\protect\mdl{sbcssr})}
+\subsection{Surface restoring to observed SST and/or SSS (\protect\mdl{sbcssr})}
 \label{SBC_ssr}
 %------------------------------------------namsbc_ssr----------------------------------------------------
 …
 IOptions are defined through the  \ngn{namsbc\_ssr} namelist variables.
 n forced mode using a flux formulation (\np{ln_flx}~=~true), a
+n forced mode using a flux formulation (\np{ln\_flx}\forcode{ = .true.}), a
 feedback term \emph{must} be added to the surface heat flux $Q_{ns}^o$:
 \begin{equation} \label{Eq_sbc_dmp_q}
 …
 The presence at the sea surface of an ice covered area modifies all the fluxes
 transmitted to the ocean. There are several way to handle sea-ice in the system
 depending on the value of the \np{nn_ice} namelist parameter found in \ngn{namsbc} namelist.
+depending on the value of the \np{nn\_ice} namelist parameter found in \ngn{namsbc} namelist.
 \begin{description}
 \item[nn{\_}ice = 0]  there will never be sea-ice in the computational domain.
 …
 % {Description of Ice-ocean interface to be added here or in LIM 2 and 3 doc ?}
+\subsection   [Interface to CICE (\textit{sbcice\_cice})]
+         {Interface to CICE (\protect\mdl{sbcice\_cice})}
+\subsection{Interface to CICE (\protect\mdl{sbcice\_cice})}
 \label{SBC_cice}
 …
 \textit{calc\_strair~=~true} and \textit{calc\_Tsfc~=~true} in the CICE name-list), or alternatively when NEMO
 is coupled to the HadGAM3 atmosphere model (with \textit{calc\_strair~=~false} and \textit{calc\_Tsfc~=~false}).
 The code is intended to be used with \np{nn_fsbc} set to 1 (although coupling ocean and ice less frequently
+The code is intended to be used with \np{nn\_fsbc} set to 1 (although coupling ocean and ice less frequently
 should work, it is possible the calculation of some of the ocean-ice fluxes needs to be modified slightly - the
 user should check that results are not significantly different to the standard case).
 …
 %        Freshwater budget control
 % -------------------------------------------------------------------------------------------------------------
+\subsection   [Freshwater budget control (\textit{sbcfwb})]
+         {Freshwater budget control (\protect\mdl{sbcfwb})}
+\subsection{Freshwater budget control (\protect\mdl{sbcfwb})}
 \label{SBC_fwb}
 …
 in the freshwater fluxes. In \NEMO, two way of controlling the the freshwater budget.
 \begin{description}
 \item[\forcode{nn_fwb = 0}]  no control at all. The mean sea level is free to drift, and will
+\item[\np{nn\_fwb}\forcode{ = 0}]  no control at all. The mean sea level is free to drift, and will
 certainly do so.
 \item[\forcode{nn_fwb = 1}]  global mean \textit{emp} set to zero at each model time step.
+\item[\np{nn\_fwb}\forcode{ = 1}]  global mean \textit{emp} set to zero at each model time step.
 %Note that with a sea-ice model, this technique only control the mean sea level with linear free surface (\key{vvl} not defined) and no mass flux between ocean and ice (as it is implemented in the current ice-ocean coupling).
 \item[\forcode{nn_fwb = 2}]  freshwater budget is adjusted from the previous year annual
+\item[\np{nn\_fwb}\forcode{ = 2}]  freshwater budget is adjusted from the previous year annual
 mean budget which is read in the \textit{EMPave\_old.dat} file. As the model uses the
 Boussinesq approximation, the annual mean fresh water budget is simply evaluated
 …
 %        Neutral Drag Coefficient from external wave model
 % -------------------------------------------------------------------------------------------------------------
 \subsection   [Neutral drag coefficient from external wave model (\textit{sbcwave})]
               {Neutral drag coefficient from external wave model (\protect\mdl{sbcwave})}
+\subsection[Neutral drag coeff. from external wave model (\protect\mdl{sbcwave})]
+            {Neutral drag coefficient from external wave model (\protect\mdl{sbcwave})}
 \label{SBC_wave}
 %------------------------------------------namwave----------------------------------------------------
 …
 %-------------------------------------------------------------------------------------------------------------
 In order to read a neutral drag coeff, from an external data source ($i.e.$ a wave model), the
 logical variable \np{ln_cdgw} in \ngn{namsbc} namelist must be set to \textit{true}.
 The \mdl{sbcwave} module containing the routine \np{sbc_wave} reads the
+In order to read a neutral drag coefficient, from an external data source ($i.e.$ a wave model), the
+logical variable \np{ln\_cdgw} in \ngn{namsbc} namelist must be set to \forcode{.true.}.
+The \mdl{sbcwave} module containing the routine \np{sbc\_wave} reads the
 namelist \ngn{namsbc\_wave} (for external data names, locations, frequency, interpolation and all
 the miscellanous options allowed by Input Data generic Interface see \S\ref{SBC_input})

branches/2017/dev_merge_2017/DOC/tex_sub/chap_STO.tex

-                      r9392
+                      r9393
 % Chapter stochastic parametrization of EOS (STO)
 % ================================================================
 \chapter{Stochastic parametrization of EOS (STO)}
+\chapter{Stochastic Parametrization of EOS (STO)}
 \label{STO}
 …
 Parameters for the processes can be specified through the following \ngn{namsto} namelist parameters:
 \begin{description}
    \item[\np{nn_sto_eos}]   : number of independent random walks
    \item[\np{rn_eos_stdxy}] : random walk horz. standard deviation (in grid points)
    \item[\np{rn_eos_stdz}]  : random walk vert. standard deviation (in grid points)
    \item[\np{rn_eos_tcor}]  : random walk time correlation (in timesteps)
    \item[\np{nn_eos_ord}]   : order of autoregressive processes
    \item[\np{nn_eos_flt}]   : passes of Laplacian filter
    \item[\np{rn_eos_lim}]   : limitation factor (default = 3.0)
+   \item[\np{nn\_sto\_eos}]   : number of independent random walks
+   \item[\np{rn\_eos\_stdxy}] : random walk horz. standard deviation (in grid points)
+   \item[\np{rn\_eos\_stdz}]  : random walk vert. standard deviation (in grid points)
+   \item[\np{rn\_eos\_tcor}]  : random walk time correlation (in timesteps)
+   \item[\np{nn\_eos\_ord}]   : order of autoregressive processes
+   \item[\np{nn\_eos\_flt}]   : passes of Laplacian filter
+   \item[\np{rn\_eos\_lim}]   : limitation factor (default = 3.0)
 \end{description}
 This routine also includes the initialization (seeding) of the random number generator.
 The third routine (\rou{sto\_rst\_write}) writes a restart file (which suffix name is
 given by \np{cn_storst_out} namelist parameter) containing the current value of
+given by \np{cn\_storst\_out} namelist parameter) containing the current value of
 all autoregressive processes to allow restarting a simulation from where it has been interrupted.
 This file also contains the current state of the random number generator.
 When \np{ln_rststo} is set to \textit{true}), the restart file (which suffix name is
 given by \np{cn_storst_in} namelist parameter) is read by the initialization routine
+When \np{ln\_rststo} is set to \forcode{.true.}), the restart file (which suffix name is
+given by \np{cn\_storst\_in} namelist parameter) is read by the initialization routine
 (\rou{sto\_par\_init}). The simulation will continue exactly as if it was not interrupted
 only  when \np{ln_rstseed} is set to \textit{true}, $i.e.$ when the state of
+only  when \np{ln\_rstseed} is set to \forcode{.true.}, $i.e.$ when the state of
 the random number generator is read in the restart file.

branches/2017/dev_merge_2017/DOC/tex_sub/chap_TRA.tex

-                      r9392
+                      r9393
 The user has the option of extracting each tendency term on the RHS of the tracer
 equation for output (\np{ln_tra_trd} or \np{ln_tra_mxl}~=~true), as described in Chap.~\ref{DIA}.
+equation for output (\np{ln\_tra\_trd} or \np{ln\_tra\_mxl}\forcode{ = .true.}), as described in Chap.~\ref{DIA}.
 $\ $\newline    % force a new ligne
 …
 % Tracer Advection
 % ================================================================
+\section  [Tracer Advection (\textit{traadv})]
+      {Tracer Advection (\protect\mdl{traadv})}
+\section{Tracer advection (\protect\mdl{traadv})}
 \label{TRA_adv}
 %------------------------------------------namtra_adv-----------------------------------------------------
 …
 %-------------------------------------------------------------------------------------------------------------
 When considered ($i.e.$ when \np{ln_traadv_NONE} is not set to \textit{true}),
+When considered ($i.e.$ when \np{ln\_traadv\_NONE} is not set to \forcode{.true.}),
 the advection tendency of a tracer is expressed in flux form,
 $i.e.$ as the divergence of the advective fluxes. Its discrete expression is given by :
 …
 by using the following equality : $\nabla \cdot \left( \vect{U}\,T \right)=\vect{U} \cdot \nabla T$
 which results from the use of the continuity equation,  $\partial _t e_3 + e_3\;\nabla \cdot \vect{U}=0$
 (which reduces to $\nabla \cdot \vect{U}=0$ in linear free surface, $i.e.$ \forcode{ln_linssh = .true.}).
+(which reduces to $\nabla \cdot \vect{U}=0$ in linear free surface, $i.e.$ \np{ln\_linssh}\forcode{ = .true.}).
 Therefore it is of paramount importance to design the discrete analogue of the
 advection tendency so that it is consistent with the continuity equation in order to
 …
 boundary condition depends on the type of sea surface chosen:
 \begin{description}
 \item [linear free surface:] (\forcode{ln_linssh = .true.}) the first level thickness is constant in time:
+\item [linear free surface:] (\np{ln\_linssh}\forcode{ = .true.}) the first level thickness is constant in time:
 the vertical boundary condition is applied at the fixed surface $z=0$
 rather than on the moving surface $z=\eta$. There is a non-zero advective
 …
 $\left. {\tau _w } \right|_{k=1/2} =T_{k=1} $, $i.e.$
 the product of surface velocity (at $z=0$) by the first level tracer value.
 \item [non-linear free surface:] (\forcode{ln_linssh = .false.})
+\item [non-linear free surface:] (\np{ln\_linssh}\forcode{ = .false.})
 convergence/divergence in the first ocean level moves the free surface
 up/down. There is no tracer advection through it so that the advective
 …
 Estimated Streaming Terms scheme (QUICKEST).
 The choice is made in the \textit{\ngn{namtra\_adv}} namelist, by
 setting to \textit{true} one of the logicals \textit{ln\_traadv\_xxx}.
+setting to \forcode{.true.} one of the logicals \textit{ln\_traadv\_xxx}.
 The corresponding code can be found in the \textit{traadv\_xxx.F90} module,
 where \textit{xxx} is a 3 or 4 letter acronym corresponding to each scheme.
 By default ($i.e.$ in the reference namelist, \ngn{namelist\_ref}), all the logicals
 are set to \textit{false}. If the user does not select an advection scheme
+are set to \forcode{.false.}. If the user does not select an advection scheme
 in the configuration namelist (\ngn{namelist\_cfg}), the tracers will \textit{not} be advected !
 …
 %        2nd and 4th order centred schemes
 % -------------------------------------------------------------------------------------------------------------
+\subsection [Centred schemes (CEN) (\protect\np{ln_traadv_cen})]
+            {Centred schemes (CEN) (\protect\forcode{ln_traadv_cen = .true.})}
+\subsection{CEN: Centred scheme (\protect\np{ln\_traadv\_cen}\forcode{ = .true.})}
 \label{TRA_adv_cen}
 %        2nd order centred scheme
 The centred advection scheme (CEN) is used when \np{ln_traadv_cen}~=~\textit{true}.
+The centred advection scheme (CEN) is used when \np{ln\_traadv\_cen}\forcode{ = .true.}.
 Its order ($2^{nd}$ or $4^{th}$) can be chosen independently on horizontal (iso-level)
 and vertical direction by setting \np{nn_cen_h} and \np{nn_cen_v} to $2$ or $4$.
+and vertical direction by setting \np{nn\_cen\_h} and \np{nn\_cen\_v} to $2$ or $4$.
 CEN implementation can be found in the \mdl{traadv\_cen} module.
 …
 =\overline{   T - \frac{1}{6}\,\delta _i \left[ \delta_{i+1/2}[T] \,\right]   }^{\,i+1/2}
 \end{equation}
 In the vertical direction (\np{nn_cen_v}=$4$), a $4^{th}$ COMPACT interpolation
+In the vertical direction (\np{nn\_cen\_v}\forcode{ = 4}), a $4^{th}$ COMPACT interpolation
 has been prefered \citep{Demange_PhD2014}.
 In the COMPACT scheme, both the field and its derivative are interpolated,
 …
 The expression \textit{$4^{th}$ order scheme} used in oceanographic literature
 is usually associated with the scheme presented here.
 Introducing a \textit{true} $4^{th}$ order advection scheme is feasible but,
+Introducing a \forcode{.true.} $4^{th}$ order advection scheme is feasible but,
 for consistency reasons, it requires changes in the discretisation of the tracer
 advection together with changes in the continuity equation,
 …
 %        FCT scheme
 % -------------------------------------------------------------------------------------------------------------
+\subsection   [Flux Corrected Transport schemes (FCT) (\protect\np{ln_traadv_fct})]
+         {Flux Corrected Transport schemes (FCT) (\protect\forcode{ln_traadv_fct = .true.})}
+\subsection{FCT: Flux Corrected Transport scheme (\protect\np{ln\_traadv\_fct}\forcode{ = .true.})}
 \label{TRA_adv_tvd}
 The Flux Corrected Transport schemes (FCT) is used when \np{ln_traadv_fct}~=~\textit{true}.
+The Flux Corrected Transport schemes (FCT) is used when \np{ln\_traadv\_fct}\forcode{ = .true.}.
 Its order ($2^{nd}$ or $4^{th}$) can be chosen independently on horizontal (iso-level)
 and vertical direction by setting \np{nn_fct_h} and \np{nn_fct_v} to $2$ or $4$.
+and vertical direction by setting \np{nn\_fct\_h} and \np{nn\_fct\_v} to $2$ or $4$.
 FCT implementation can be found in the \mdl{traadv\_fct} module.
 …
 where $c_u$ is a flux limiter function taking values between 0 and 1.
 The FCT order is the one of the centred scheme used ($i.e.$ it depends on the setting of
 \np{nn_fct_h} and \np{nn_fct_v}.
+\np{nn\_fct\_h} and \np{nn\_fct\_v}.
 There exist many ways to define $c_u$, each corresponding to a different
 FCT scheme. The one chosen in \NEMO is described in \citet{Zalesak_JCP79}.
 …
 A comparison of FCT-2 with MUSCL and a MPDATA scheme can be found in \citet{Levy_al_GRL01}.
 An additional option has been added controlled by \np{nn_fct_zts}. By setting this integer to
+An additional option has been added controlled by \np{nn\_fct\_zts}. By setting this integer to
 a value larger than zero, a $2^{nd}$ order FCT scheme is used on both horizontal and vertical direction,
 but on the latter, a split-explicit time stepping is used, with a number of sub-timestep equals
 to \np{nn_fct_zts}. This option can be useful when the size of the timestep is limited
+to \np{nn\_fct\_zts}. This option can be useful when the size of the timestep is limited
 by vertical advection \citep{Lemarie_OM2015}. Note that in this case, a similar split-explicit
 time stepping should be used on vertical advection of momentum to insure a better stability
 …
 %        MUSCL scheme
 % -------------------------------------------------------------------------------------------------------------
+\subsection[MUSCL scheme  (\protect\np{ln_traadv_mus})]
+   {Monotone Upstream Scheme for Conservative Laws (MUSCL) (\protect\forcode{ln_traadv_mus = .true.})}
+\subsection{MUSCL: Monotone Upstream Scheme for Conservative Laws (\protect\np{ln\_traadv\_mus}\forcode{ = .true.})}
 \label{TRA_adv_mus}
 The Monotone Upstream Scheme for Conservative Laws (MUSCL) is used when \np{ln_traadv_mus}~=~\textit{true}.
+The Monotone Upstream Scheme for Conservative Laws (MUSCL) is used when \np{ln\_traadv\_mus}\forcode{ = .true.}.
 MUSCL implementation can be found in the \mdl{traadv\_mus} module.
 …
 the \textit{positive} character of the scheme.
 In addition, fluxes round a grid-point where a runoff is applied can optionally be
 computed using upstream fluxes (\np{ln_mus_ups}~=~\textit{true}).
+computed using upstream fluxes (\np{ln\_mus\_ups}\forcode{ = .true.}).
 % -------------------------------------------------------------------------------------------------------------
 %        UBS scheme
 % -------------------------------------------------------------------------------------------------------------
+\subsection   [Upstream-Biased Scheme (UBS) (\protect\np{ln_traadv_ubs})]
+         {Upstream-Biased Scheme (UBS) (\protect\forcode{ln_traadv_ubs = .true.})}
+\subsection{UBS a.k.a. UP3: Upstream-Biased Scheme (\protect\np{ln\_traadv\_ubs}\forcode{ = .true.})}
 \label{TRA_adv_ubs}
 The Upstream-Biased Scheme (UBS) is used when \np{ln_traadv_ubs}~=~\textit{true}.
+The Upstream-Biased Scheme (UBS) is used when \np{ln\_traadv\_ubs}\forcode{ = .true.}.
 UBS implementation can be found in the \mdl{traadv\_mus} module.
 …
 where the control of artificial diapycnal fluxes is of paramount importance \citep{Shchepetkin_McWilliams_OM05, Demange_PhD2014}.
 Therefore the vertical flux is evaluated using either a $2^nd$ order FCT scheme
 or a $4^th$ order COMPACT scheme (\forcode{nn_cen_v = 2} or 4).
+or a $4^th$ order COMPACT scheme (\np{nn\_cen\_v}\forcode{ = 2 or 4}).
 For stability reasons  (see \S\ref{STP}),
 …
 %        QCK scheme
 % -------------------------------------------------------------------------------------------------------------
+\subsection   [QUICKEST scheme (QCK) (\protect\np{ln_traadv_qck})]
+         {QUICKEST scheme (QCK) (\protect\forcode{ln_traadv_qck = .true.})}
+\subsection{QCK: QuiCKest scheme (\protect\np{ln\_traadv\_qck}\forcode{ = .true.})}
 \label{TRA_adv_qck}
 The Quadratic Upstream Interpolation for Convective Kinematics with
 Estimated Streaming Terms (QUICKEST) scheme proposed by \citet{Leonard1979}
 is used when \np{ln_traadv_qck}~=~\textit{true}.
+is used when \np{ln\_traadv\_qck}\forcode{ = .true.}.
 QUICKEST implementation can be found in the \mdl{traadv\_qck} module.
 …
 % Tracer Lateral Diffusion
 % ================================================================
+\section  [Tracer Lateral Diffusion (\textit{traldf})]
+      {Tracer Lateral Diffusion (\protect\mdl{traldf})}
+\section{Tracer lateral diffusion (\protect\mdl{traldf})}
 \label{TRA_ldf}
 %-----------------------------------------nam_traldf------------------------------------------------------
 …
 except for the pure vertical component that appears when a rotation tensor is used.
 This latter component is solved implicitly together with the vertical diffusion term (see \S\ref{STP}).
 When \np{ln_traldf_msc}~=~\textit{true}, a Method of Stabilizing Correction is used in which
+When \np{ln\_traldf\_msc}\forcode{ = .true.}, a Method of Stabilizing Correction is used in which
 the pure vertical component is split into an explicit and an implicit part \citep{Lemarie_OM2012}.
 …
 %        Type of operator
 % -------------------------------------------------------------------------------------------------------------
 \subsection   [Type of operator (\protect\np{ln\_traldf\{\_NONE, \_lap, \_blp\}})]
               {Type of operator (\protect\np{ln_traldf_NONE}, \protect\np{ln_traldf_lap}, or \protect\np{ln_traldf_blp} = true) }
+\subsection[Type of operator (\protect\np{ln\_traldf}\{\_NONE,\_lap,\_blp\}\})]
+              {Type of operator (\protect\np{ln\_traldf\_NONE}, \protect\np{ln\_traldf\_lap}, or \protect\np{ln\_traldf\_blp}) }
 \label{TRA_ldf_op}
 Three operator options are proposed and, one and only one of them must be selected:
 \begin{description}
 \item [\np{ln_traldf_NONE}] = true : no operator selected, the lateral diffusive tendency will not be
+\item [\np{ln\_traldf\_NONE}\forcode{ = .true.}]: no operator selected, the lateral diffusive tendency will not be
 applied to the tracer equation. This option can be used when the selected advection scheme
 is diffusive enough (MUSCL scheme for example).
 \item [ \np{ln_traldf_lap}] = true : a laplacian operator is selected. This harmonic operator
+\item [\np{ln\_traldf\_lap}\forcode{ = .true.}]: a laplacian operator is selected. This harmonic operator
 takes the following expression:  $\mathpzc{L}(T)=\nabla \cdot A_{ht}\;\nabla T $,
 where the gradient operates along the selected direction (see \S\ref{TRA_ldf_dir}),
 and $A_{ht}$ is the eddy diffusivity coefficient expressed in $m^2/s$ (see Chap.~\ref{LDF}).
 \item [\np{ln_traldf_blp}] = true : a bilaplacian operator is selected. This biharmonic operator
+\item [\np{ln\_traldf\_blp}\forcode{ = .true.}]: a bilaplacian operator is selected. This biharmonic operator
 takes the following expression:
 $\mathpzc{B}=- \mathpzc{L}\left(\mathpzc{L}(T) \right) = -\nabla \cdot b\nabla \left( {\nabla \cdot b\nabla T} \right)$
 …
 %        Direction of action
 % -------------------------------------------------------------------------------------------------------------
 \subsection   [Direction of action (\protect\np{ln\_traldf\{\_lev, \_hor, \_iso, \_triad\}})]
               {Direction of action (\protect\np{ln_traldf_lev}, \textit{...\_hor}, \textit{...\_iso}, or \textit{...\_triad} = true) }
+\subsection[Action direction (\protect\np{ln\_traldf}\{\_lev,\_hor,\_iso,\_triad\})]
+              {Direction of action (\protect\np{ln\_traldf\_lev}, \protect\np{ln\_traldf\_hor}, \protect\np{ln\_traldf\_iso}, or \protect\np{ln\_traldf\_triad}) }
 \label{TRA_ldf_dir}
 The choice of a direction of action determines the form of operator used.
 The operator is a simple (re-entrant) laplacian acting in the (\textbf{i},\textbf{j}) plane
 when iso-level option is used (\np{ln_traldf_lev}~=~\textit{true})
+when iso-level option is used (\np{ln\_traldf\_lev}\forcode{ = .true.})
 or when a horizontal ($i.e.$ geopotential) operator is demanded in \textit{z}-coordinate
 (\np{ln_traldf_hor} and \np{ln_zco} equal \textit{true}).
+(\np{ln\_traldf\_hor} and \np{ln\_zco} equal \forcode{.true.}).
 The associated code can be found in the \mdl{traldf\_lap\_blp} module.
 The operator is a rotated (re-entrant) laplacian when the direction along which it acts
 does not coincide with the iso-level surfaces,
 that is when standard or triad iso-neutral option is used (\np{ln_traldf_iso} or
  \np{ln_traldf_triad} equals \textit{true}, see \mdl{traldf\_iso} or \mdl{traldf\_triad} module, resp.),
+that is when standard or triad iso-neutral option is used (\np{ln\_traldf\_iso} or
+ \np{ln\_traldf\_triad} equals \forcode{.true.}, see \mdl{traldf\_iso} or \mdl{traldf\_triad} module, resp.),
 or when a horizontal ($i.e.$ geopotential) operator is demanded in \textit{s}-coordinate
 (\np{ln_traldf_hor} and \np{ln_sco} equal \textit{true})
+(\np{ln\_traldf\_hor} and \np{ln\_sco} equal \forcode{.true.})
 \footnote{In this case, the standard iso-neutral operator will be automatically selected}.
 In that case, a rotation is applied to the gradient(s) that appears in the operator
 …
 %       iso-level operator
 % -------------------------------------------------------------------------------------------------------------
+\subsection   [Iso-level (bi-)laplacian operator ( \protect\np{ln_traldf_iso})]
+         {Iso-level (bi-)laplacian operator ( \protect\np{ln_traldf_iso}) }
+\subsection{Iso-level (bi-)laplacian operator ( \protect\np{ln\_traldf\_iso}) }
 \label{TRA_ldf_lev}
 …
 It is a \emph{horizontal} operator ($i.e.$ acting along geopotential surfaces) in the $z$-coordinate
 with or without partial steps, but is simply an iso-level operator in the $s$-coordinate.
 It is thus used when, in addition to \np{ln_traldf_lap} or \np{ln_traldf_blp}~=~\textit{true},
 we have \np{ln_traldf_lev}~=~\textit{true} or \np{ln_traldf_hor}~=~\np{ln_zco}~=~\textit{true}.
+It is thus used when, in addition to \np{ln\_traldf\_lap} or \np{ln\_traldf\_blp}\forcode{ = .true.},
+we have \np{ln\_traldf\_lev}\forcode{ = .true.} or \np{ln\_traldf\_hor}~=~\np{ln\_zco}\forcode{ = .true.}.
 In both cases, it significantly contributes to diapycnal mixing.
 It is therefore never recommended, even when using it in the bilaplacian case.
 Note that in the partial step $z$-coordinate (\forcode{ln_zps = .true.}), tracers in horizontally
+Note that in the partial step $z$-coordinate (\np{ln\_zps}\forcode{ = .true.}), tracers in horizontally
 adjacent cells are located at different depths in the vicinity of the bottom.
 In this case, horizontal derivatives in (\ref{Eq_tra_ldf_lap}) at the bottom level
 …
 %         Rotated laplacian operator
 % -------------------------------------------------------------------------------------------------------------
+\subsection   [Standard and triad rotated (bi-)laplacian operator]
+               {Standard and triad (bi-)laplacian operator}
+\subsection{Standard and triad (bi-)laplacian operator}
 \label{TRA_ldf_iso_triad}
 %&&    Standard rotated (bi-)laplacian operator
 %&& ----------------------------------------------
+\subsubsection   [Standard rotated (bi-)laplacian operator (\protect\mdl{traldf\_iso})]
+                 {Standard rotated (bi-)laplacian operator (\protect\mdl{traldf\_iso})}
+\subsubsection{Standard rotated (bi-)laplacian operator (\protect\mdl{traldf\_iso})}
 \label{TRA_ldf_iso}
 The general form of the second order lateral tracer subgrid scale physics
 …
 ($z$- or $s$-surfaces) and the surface along which the diffusion operator
 acts ($i.e.$ horizontal or iso-neutral surfaces).  It is thus used when,
 in addition to \np{ln_traldf_lap}= true, we have \forcode{ln_traldf_iso = .true.},
 or both \forcode{ln_traldf_hor = .true.} and \forcode{ln_zco = .true.}. The way these
+in addition to \np{ln\_traldf\_lap}\forcode{ = .true.}, we have \np{ln\_traldf\_iso}\forcode{ = .true.},
+or both \np{ln\_traldf\_hor}\forcode{ = .true.} and \np{ln\_zco}\forcode{ = .true.}. The way these
 slopes are evaluated is given in \S\ref{LDF_slp}. At the surface, bottom
 and lateral boundaries, the turbulent fluxes of heat and salt are set to zero
 …
 background horizontal diffusion \citep{Guilyardi_al_CD01}.
 Note that in the partial step $z$-coordinate (\forcode{ln_zps = .true.}), the horizontal derivatives
+Note that in the partial step $z$-coordinate (\np{ln\_zps}\forcode{ = .true.}), the horizontal derivatives
 at the bottom level in \eqref{Eq_tra_ldf_iso} require a specific treatment.
 They are calculated in module zpshde, described in \S\ref{TRA_zpshde}.
 …
 %&&     Triad rotated (bi-)laplacian operator
 %&&  -------------------------------------------
+\subsubsection   [Triad rotated (bi-)laplacian operator (\protect\np{ln_traldf_triad})]
+                 {Triad rotated (bi-)laplacian operator (\protect\np{ln_traldf_triad})}
+\subsubsection{Triad rotated (bi-)laplacian operator (\protect\np{ln\_traldf\_triad})}
 \label{TRA_ldf_triad}
 If the Griffies triad scheme is employed (\forcode{ln_traldf_triad = .true.} ; see App.\ref{sec:triad})
+If the Griffies triad scheme is employed (\np{ln\_traldf\_triad}\forcode{ = .true.} ; see App.\ref{sec:triad})
 An alternative scheme developed by \cite{Griffies_al_JPO98} which ensures tracer variance decreases
 is also available in \NEMO (\forcode{ln_traldf_grif = .true.}). A complete description of
+is also available in \NEMO (\np{ln\_traldf\_grif}\forcode{ = .true.}). A complete description of
 the algorithm is given in App.\ref{sec:triad}.
 …
 %&&    Option for the rotated operators
 %&& ----------------------------------------------
+\subsubsection   [Option for the rotated operators]
+                 {Option for the rotated operators}
+\subsubsection{Option for the rotated operators}
 \label{TRA_ldf_options}
 \np{ln_traldf_msc} = Method of Stabilizing Correction (both operators)
 \np{rn_slpmax} = slope limit (both operators)
 \np{ln_triad_iso} = pure horizontal mixing in ML (triad only)
 \np{rn_sw_triad} =1 switching triad ; =0 all 4 triads used (triad only)
 \np{ln_botmix_triad} = lateral mixing on bottom (triad only)
+\np{ln\_traldf\_msc} = Method of Stabilizing Correction (both operators)
+\np{rn\_slpmax} = slope limit (both operators)
+\np{ln\_triad\_iso} = pure horizontal mixing in ML (triad only)
+\np{rn\_sw\_triad} =1 switching triad ; =0 all 4 triads used (triad only)
+\np{ln\_botmix\_triad} = lateral mixing on bottom (triad only)
 % ================================================================
 % Tracer Vertical Diffusion
 % ================================================================
+\section  [Tracer Vertical Diffusion (\textit{trazdf})]
+      {Tracer Vertical Diffusion (\protect\mdl{trazdf})}
+\section{Tracer vertical diffusion (\protect\mdl{trazdf})}
 \label{TRA_zdf}
 %--------------------------------------------namzdf---------------------------------------------------------
 …
 The large eddy coefficient found in the mixed layer together with high
 vertical resolution implies that in the case of explicit time stepping
 (\forcode{ln_zdfexp = .true.}) there would be too restrictive a constraint on
+(\np{ln\_zdfexp}\forcode{ = .true.}) there would be too restrictive a constraint on
 the time step. Therefore, the default implicit time stepping is preferred
 for the vertical diffusion since it overcomes the stability constraint.
 A forward time differencing scheme (\forcode{ln_zdfexp = .true.}) using a time
 splitting technique (\np{nn_zdfexp} $> 1$) is provided as an alternative.
 Namelist variables \np{ln_zdfexp} and \np{nn_zdfexp} apply to both
+A forward time differencing scheme (\np{ln\_zdfexp}\forcode{ = .true.}) using a time
+splitting technique (\np{nn\_zdfexp} $> 1$) is provided as an alternative.
+Namelist variables \np{ln\_zdfexp} and \np{nn\_zdfexp} apply to both
 tracers and dynamics.
 …
 % External Forcing
 % ================================================================
 \section{External Forcing}
+\section{External forcing}
 \label{TRA_sbc_qsr_bbc}
 …
 %        surface boundary condition
 % -------------------------------------------------------------------------------------------------------------
+\subsection   [Surface boundary condition (\textit{trasbc})]
+         {Surface boundary condition (\protect\mdl{trasbc})}
+\subsection{Surface boundary condition (\protect\mdl{trasbc})}
 \label{TRA_sbc}
 …
 divergence of odd and even time step (see \S\ref{STP}).
 In the linear free surface case (\np{ln_linssh}~=~\textit{true}),
+In the linear free surface case (\np{ln\_linssh}\forcode{ = .true.}),
 an additional term has to be added on both temperature and salinity.
 On temperature, this term remove the heat content associated with mass exchange
 …
 %        Solar Radiation Penetration
 % -------------------------------------------------------------------------------------------------------------
+\subsection   [Solar Radiation Penetration (\textit{traqsr})]
+         {Solar Radiation Penetration (\protect\mdl{traqsr})}
+\subsection{Solar radiation penetration (\protect\mdl{traqsr})}
 \label{TRA_qsr}
 %--------------------------------------------namqsr--------------------------------------------------------
 …
 Options are defined through the  \ngn{namtra\_qsr} namelist variables.
 When the penetrative solar radiation option is used (\forcode{ln_flxqsr = .true.}),
+When the penetrative solar radiation option is used (\np{ln\_flxqsr}\forcode{ = .true.}),
 the solar radiation penetrates the top few tens of meters of the ocean. If it is not used
 (\forcode{ln_flxqsr = .false.}) all the heat flux is absorbed in the first ocean level.
+(\np{ln\_flxqsr}\forcode{ = .false.}) all the heat flux is absorbed in the first ocean level.
 Thus, in the former case a term is added to the time evolution equation of
 temperature \eqref{Eq_PE_tra_T} and the surface boundary condition is
 …
 wavelengths contribute to heating the upper few tens of centimetres. The fraction of $Q_{sr}$
 that resides in these almost non-penetrative wavebands, $R$, is $\sim 58\%$ (specified
 through namelist parameter \np{rn_abs}).  It is assumed to penetrate the ocean
+through namelist parameter \np{rn\_abs}).  It is assumed to penetrate the ocean
 with a decreasing exponential profile, with an e-folding depth scale, $\xi_0$,
 of a few tens of centimetres (typically $\xi_0=0.35~m$ set as \np{rn_si0} in the namtra\_qsr namelist).
+of a few tens of centimetres (typically $\xi_0=0.35~m$ set as \np{rn\_si0} in the namtra\_qsr namelist).
 For shorter wavelengths (400-700~nm), the ocean is more transparent, and solar energy
 propagates to larger depths where it contributes to
 local heating.
 The way this second part of the solar energy penetrates into the ocean depends on
 which formulation is chosen. In the simple 2-waveband light penetration scheme  (\forcode{ln_qsr_2bd = .true.})
+which formulation is chosen. In the simple 2-waveband light penetration scheme  (\np{ln\_qsr\_2bd}\forcode{ = .true.})
 a chlorophyll-independent monochromatic formulation is chosen for the shorter wavelengths,
 leading to the following expression  \citep{Paulson1977}:
 …
 \end{equation}
 where $\xi_1$ is the second extinction length scale associated with the shorter wavelengths.
 It is usually chosen to be 23~m by setting the \np{rn_si0} namelist parameter.
+It is usually chosen to be 23~m by setting the \np{rn\_si0} namelist parameter.
 The set of default values ($\xi_0$, $\xi_1$, $R$) corresponds to a Type I water in
 Jerlov's (1968) classification (oligotrophic waters).
 …
 computational efficiency. The 2-bands formulation does not reproduce the full model very well.
 The RGB formulation is used when \forcode{ln_qsr_rgb = .true.}. The RGB attenuation coefficients
+The RGB formulation is used when \np{ln\_qsr\_rgb}\forcode{ = .true.}. The RGB attenuation coefficients
 ($i.e.$ the inverses of the extinction length scales) are tabulated over 61 nonuniform
 chlorophyll classes ranging from 0.01 to 10 g.Chl/L (see the routine \rou{trc\_oce\_rgb}
 in \mdl{trc\_oce} module). Four types of chlorophyll can be chosen in the RGB formulation:
 \begin{description}
 \item[\forcode{nn_chdta = 0}]
+\item[\np{nn\_chdta}\forcode{ = 0}]
 a constant 0.05 g.Chl/L value everywhere ;
 \item[\forcode{nn_chdta = 1}]
+\item[\np{nn\_chdta}\forcode{ = 1}]
 an observed time varying chlorophyll deduced from satellite surface ocean color measurement
 spread uniformly in the vertical direction ;
 \item[\forcode{nn_chdta = 2}]
+\item[\np{nn\_chdta}\forcode{ = 2}]
 same as previous case except that a vertical profile of chlorophyl is used.
 Following \cite{Morel_Berthon_LO89}, the profile is computed from the local surface chlorophyll value ;
 \item[\forcode{ln_qsr_bio = .true.}]
+\item[\np{ln\_qsr\_bio}\forcode{ = .true.}]
 simulated time varying chlorophyll by TOP biogeochemical model.
 In this case, the RGB formulation is used to calculate both the phytoplankton
 …
 %        Bottom Boundary Condition
 % -------------------------------------------------------------------------------------------------------------
+\subsection   [Bottom Boundary Condition (\textit{trabbc})]
+         {Bottom Boundary Condition (\protect\mdl{trabbc})}
+\subsection{Bottom boundary condition (\protect\mdl{trabbc})}
 \label{TRA_bbc}
 %--------------------------------------------nambbc--------------------------------------------------------
 …
 Options are defined through the  \ngn{namtra\_bbc} namelist variables.
 The presence of geothermal heating is controlled by setting the namelist
 parameter  \np{ln_trabbc} to true. Then, when \np{nn_geoflx} is set to 1,
+parameter  \np{ln\_trabbc} to true. Then, when \np{nn\_geoflx} is set to 1,
 a constant geothermal heating is introduced whose value is given by the
 \np{nn_geoflx_cst}, which is also a namelist parameter.
 When  \np{nn_geoflx} is set to 2, a spatially varying geothermal heat flux is
+\np{nn\_geoflx\_cst}, which is also a namelist parameter.
+When  \np{nn\_geoflx} is set to 2, a spatially varying geothermal heat flux is
 introduced which is provided in the \ifile{geothermal\_heating} NetCDF file
 (Fig.\ref{Fig_geothermal}) \citep{Emile-Geay_Madec_OS09}.
 …
 % Bottom Boundary Layer
 % ================================================================
+\section  [Bottom Boundary Layer (\protect\mdl{trabbl} - \protect\key{trabbl})]
+      {Bottom Boundary Layer (\protect\mdl{trabbl} - \protect\key{trabbl})}
+\section{Bottom boundary layer (\protect\mdl{trabbl} - \protect\key{trabbl})}
 \label{TRA_bbl}
 %--------------------------------------------nambbl---------------------------------------------------------
 …
 %        Diffusive BBL
 % -------------------------------------------------------------------------------------------------------------
 \subsection{Diffusive Bottom Boundary layer (\protect\forcode{nn_bbl_ldf = 1})}
+\subsection{Diffusive bottom boundary layer (\protect\np{nn\_bbl\_ldf}\forcode{ = 1})}
 \label{TRA_bbl_diff}
 When applying sigma-diffusion (\key{trabbl} defined and \np{nn_bbl_ldf} set to 1),
+When applying sigma-diffusion (\key{trabbl} defined and \np{nn\_bbl\_ldf} set to 1),
 the diffusive flux between two adjacent cells at the ocean floor is given by
 \begin{equation} \label{Eq_tra_bbl_diff}
 …
 \end{equation}
 where $A_{bbl}$ is the BBL diffusivity coefficient, given by the namelist
 parameter \np{rn_ahtbbl} and usually set to a value much larger
+parameter \np{rn\_ahtbbl} and usually set to a value much larger
 than the one used for lateral mixing in the open ocean. The constraint in \eqref{Eq_tra_bbl_coef}
 implies that sigma-like diffusion only occurs when the density above the sea floor, at the top of
 …
 %        Advective BBL
 % -------------------------------------------------------------------------------------------------------------
 \subsection   {Advective Bottom Boundary Layer  (\protect\np{nn_bbl_adv}= 1 or 2)}
+\subsection{Advective bottom boundary layer  (\protect\np{nn\_bbl\_adv}\forcode{ = 1..2})}
 \label{TRA_bbl_adv}
 …
 %%%gmcomment   :  this section has to be really written
 When applying an advective BBL (\np{nn_bbl_adv} = 1 or 2), an overturning
+When applying an advective BBL (\np{nn\_bbl\_adv}\forcode{ = 1..2}), an overturning
 circulation is added which connects two adjacent bottom grid-points only if dense
 water overlies less dense water on the slope. The density difference causes dense
 water to move down the slope.
 \np{nn_bbl_adv} = 1 : the downslope velocity is chosen to be the Eulerian
+\np{nn\_bbl\_adv}\forcode{ = 1} : the downslope velocity is chosen to be the Eulerian
 ocean velocity just above the topographic step (see black arrow in Fig.\ref{Fig_bbl})
 \citep{Beckmann_Doscher1997}. It is a \textit{conditional advection}, that is, advection
 …
 greater depth ($i.e.$ $\vect{U}  \cdot  \nabla H>0$).
 \np{nn_bbl_adv} = 2 : the downslope velocity is chosen to be proportional to $\Delta \rho$,
+\np{nn\_bbl\_adv}\forcode{ = 2} : the downslope velocity is chosen to be proportional to $\Delta \rho$,
 the density difference between the higher cell and lower cell densities \citep{Campin_Goosse_Tel99}.
 The advection is allowed only  if dense water overlies less dense water on the slope ($i.e.$
 …
 \end{equation}
 where $\gamma$, expressed in seconds, is the coefficient of proportionality
 provided as \np{rn_gambbl}, a namelist parameter, and \textit{kup} and \textit{kdwn}
+provided as \np{rn\_gambbl}, a namelist parameter, and \textit{kup} and \textit{kdwn}
 are the vertical index of the higher and lower cells, respectively.
 The parameter $\gamma$ should take a different value for each bathymetric
 …
 % Tracer damping
 % ================================================================
+\section  [Tracer damping (\textit{tradmp})]
+      {Tracer damping (\protect\mdl{tradmp})}
+\section{Tracer damping (\protect\mdl{tradmp})}
 \label{TRA_dmp}
 %--------------------------------------------namtra_dmp-------------------------------------------------
 …
 are given temperature and salinity fields (usually a climatology).
 Options are defined through the  \ngn{namtra\_dmp} namelist variables.
 The restoring term is added when the namelist parameter \np{ln_tradmp} is set to true.
 It also requires that both \np{ln_tsd_init} and \np{ln_tsd_tradmp} are set to true
 in \textit{namtsd} namelist as well as \np{sn_tem} and \np{sn_sal} structures are
+The restoring term is added when the namelist parameter \np{ln\_tradmp} is set to true.
+It also requires that both \np{ln\_tsd\_init} and \np{ln\_tsd\_tradmp} are set to true
+in \textit{namtsd} namelist as well as \np{sn\_tem} and \np{sn\_sal} structures are
 correctly set  ($i.e.$ that $T_o$ and $S_o$ are provided in input files and read
 using \mdl{fldread}, see \S\ref{SBC_fldread}).
 The restoring coefficient $\gamma$ is a three-dimensional array read in during the \rou{tra\_dmp\_init} routine. The file name is specified by the namelist variable \np{cn_resto}. The DMP\_TOOLS tool is provided to allow users to generate the netcdf file.
+The restoring coefficient $\gamma$ is a three-dimensional array read in during the \rou{tra\_dmp\_init} routine. The file name is specified by the namelist variable \np{cn\_resto}. The DMP\_TOOLS tool is provided to allow users to generate the netcdf file.
 The two main cases in which \eqref{Eq_tra_dmp} is used are \textit{(a)}
 …
 by stabilising the water column too much.
 The namelist parameter \np{nn_zdmp} sets whether the damping should be applied in the whole water column or only below the mixed layer (defined either on a density or $S_o$ criterion). It is common to set the damping to zero in the mixed layer as the adjustment time scale is short here \citep{Madec_al_JPO96}.
 \subsection[DMP\_TOOLS]{Generating \ifile{resto} using DMP\_TOOLS}
+The namelist parameter \np{nn\_zdmp} sets whether the damping should be applied in the whole water column or only below the mixed layer (defined either on a density or $S_o$ criterion). It is common to set the damping to zero in the mixed layer as the adjustment time scale is short here \citep{Madec_al_JPO96}.
+\subsection{Generating \ifile{resto} using DMP\_TOOLS}
 DMP\_TOOLS can be used to generate a netcdf file containing the restoration coefficient $\gamma$.
 Note that in order to maintain bit comparison with previous NEMO versions DMP\_TOOLS must be compiled
 and run on the same machine as the NEMO model. A \ifile{mesh\_mask} file for the model configuration is required as an input.
 This can be generated by carrying out a short model run with the namelist parameter \np{nn_msh} set to 1.
 The namelist parameter \np{ln_tradmp} will also need to be set to .false. for this to work.
+This can be generated by carrying out a short model run with the namelist parameter \np{nn\_msh} set to 1.
+The namelist parameter \np{ln\_tradmp} will also need to be set to .false. for this to work.
 The \nl{nam\_dmp\_create} namelist in the DMP\_TOOLS directory is used to specify options for the restoration coefficient.
 …
 %-------------------------------------------------------------------------------------------------------
 \np{cp_cfg}, \np{cp_cpz}, \np{jp_cfg} and \np{jperio} specify the model configuration being used and should be the same as specified in \nl{namcfg}. The variable \nl{lzoom} is used to specify that the damping is being used as in case \textit{a} above to provide boundary conditions to a zoom configuration. In the case of the arctic or antarctic zoom configurations this includes some specific treatment. Otherwise damping is applied to the 6 grid points along the ocean boundaries. The open boundaries are specified by the variables \np{lzoom_n}, \np{lzoom_e}, \np{lzoom_s}, \np{lzoom_w} in the \nl{nam\_zoom\_dmp} name list.
+\np{cp\_cfg}, \np{cp\_cpz}, \np{jp\_cfg} and \np{jperio} specify the model configuration being used and should be the same as specified in \nl{namcfg}. The variable \nl{lzoom} is used to specify that the damping is being used as in case \textit{a} above to provide boundary conditions to a zoom configuration. In the case of the arctic or antarctic zoom configurations this includes some specific treatment. Otherwise damping is applied to the 6 grid points along the ocean boundaries. The open boundaries are specified by the variables \np{lzoom\_n}, \np{lzoom\_e}, \np{lzoom\_s}, \np{lzoom\_w} in the \nl{nam\_zoom\_dmp} name list.
 The remaining switch namelist variables determine the spatial variation of the restoration coefficient in non-zoom configurations.
 \np{ln_full_field} specifies that newtonian damping should be applied to the whole model domain.
 \np{ln_med_red_seas} specifies grid specific restoration coefficients in the Mediterranean Sea
+\np{ln\_full\_field} specifies that newtonian damping should be applied to the whole model domain.
+\np{ln\_med\_red\_seas} specifies grid specific restoration coefficients in the Mediterranean Sea
 for the ORCA4, ORCA2 and ORCA05 configurations.
 If \np{ln_old_31_lev_code} is set then the depth variation of the coeffients will be specified as
+If \np{ln\_old\_31\_lev\_code} is set then the depth variation of the coeffients will be specified as
 a function of the model number. This option is included to allow backwards compatability of the ORCA2 reference
 configurations with previous model versions.
 \np{ln_coast} specifies that the restoration coefficient should be reduced near to coastlines.
 This option only has an effect if \np{ln_full_field} is true.
 \np{ln_zero_top_layer} specifies that the restoration coefficient should be zero in the surface layer.
 Finally \np{ln_custom} specifies that the custom module will be called.
+\np{ln\_coast} specifies that the restoration coefficient should be reduced near to coastlines.
+This option only has an effect if \np{ln\_full\_field} is true.
+\np{ln\_zero\_top\_layer} specifies that the restoration coefficient should be zero in the surface layer.
+Finally \np{ln\_custom} specifies that the custom module will be called.
 This module is contained in the file custom.F90 and can be edited by users. For example damping could be applied in a specific region.
 The restoration coefficient can be set to zero in equatorial regions by specifying a positive value of \np{nn_hdmp}.
+The restoration coefficient can be set to zero in equatorial regions by specifying a positive value of \np{nn\_hdmp}.
 Equatorward of this latitude the restoration coefficient will be zero with a smooth transition to
 the full values of a 10\deg latitud band.
 This is often used because of the short adjustment time scale in the equatorial region
 \citep{Reverdin1991, Fujio1991, Marti_PhD92}. The time scale associated with the damping depends on the depth as a
 hyperbolic tangent, with \np{rn_surf} as surface value, \np{rn_bot} as bottom value and a transition depth of \np{rn_dep}.
+hyperbolic tangent, with \np{rn\_surf} as surface value, \np{rn\_bot} as bottom value and a transition depth of \np{rn\_dep}.
 % ================================================================
 % Tracer time evolution
 % ================================================================
+\section  [Tracer time evolution (\textit{tranxt})]
+      {Tracer time evolution (\protect\mdl{tranxt})}
+\section{Tracer time evolution (\protect\mdl{tranxt})}
 \label{TRA_nxt}
 %--------------------------------------------namdom-----------------------------------------------------
 …
 the subscript $f$ denotes filtered values, $\gamma$ is the Asselin coefficient,
 and $S$ is the total forcing applied on $T$ ($i.e.$ fluxes plus content in mass exchanges).
 $\gamma$ is initialized as \np{rn_atfp} (\textbf{namelist} parameter).
 Its default value is \np{rn_atfp}=$10^{-3}$. Note that the forcing correction term in the filter
 is not applied in linear free surface (\jp{lk\_vvl}=false) (see \S\ref{TRA_sbc}.
+$\gamma$ is initialized as \np{rn\_atfp} (\textbf{namelist} parameter).
+Its default value is \np{rn\_atfp}\forcode{ = 10.e-3}. Note that the forcing correction term in the filter
+is not applied in linear free surface (\jp{lk\_vvl}\forcode{ = .false.}) (see \S\ref{TRA_sbc}.
 Not also that in constant volume case, the time stepping is performed on $T$,
 not on its content, $e_{3t}T$.
 …
 % Equation of State (eosbn2)
 % ================================================================
+\section  [Equation of State (\textit{eosbn2}) ]
+      {Equation of State (\protect\mdl{eosbn2}) }
+\section{Equation of state (\protect\mdl{eosbn2}) }
 \label{TRA_eosbn2}
 %--------------------------------------------nameos-----------------------------------------------------
 …
 %        Equation of State
 % -------------------------------------------------------------------------------------------------------------
 \subsection{Equation Of Seawater (\protect\np{nn_eos} = -1, 0, or 1)}
+\subsection{Equation of seawater (\protect\np{nn\_eos}\forcode{ = -1..1})}
 \label{TRA_eos}
 …
 density in the World Ocean varies by no more than 2$\%$ from that value \citep{Gill1982}.
 Options are defined through the  \ngn{nameos} namelist variables, and in particular \np{nn_eos}
 which controls the EOS used (=-1 for TEOS10 ; =0 for EOS-80 ; =1 for S-EOS).
+Options are defined through the  \ngn{nameos} namelist variables, and in particular \np{nn\_eos}
+which controls the EOS used (\forcode{= -1} for TEOS10 ; \forcode{= 0} for EOS-80 ; \forcode{= 1} for S-EOS).
 \begin{description}
 \item[\np{nn_eos}$=-1$] the polyTEOS10-bsq equation of seawater \citep{Roquet_OM2015} is used.
+\item[\np{nn\_eos}\forcode{ = -1}] the polyTEOS10-bsq equation of seawater \citep{Roquet_OM2015} is used.
 The accuracy of this approximation is comparable to the TEOS-10 rational function approximation,
 but it is optimized for a boussinesq fluid and the polynomial expressions have simpler
 …
 $\Theta$ and $S_A$. In particular, the initial state deined by the user have to be given as
 \textit{Conservative} Temperature and \textit{Absolute} Salinity.
 In addition, setting \np{ln_useCT} to \textit{true} convert the Conservative SST to potential SST
+In addition, setting \np{ln\_useCT} to \forcode{.true.} convert the Conservative SST to potential SST
 prior to either computing the air-sea and ice-sea fluxes (forced mode)
 or sending the SST field to the atmosphere (coupled mode).
 \item[\np{nn_eos}$=0$] the polyEOS80-bsq equation of seawater is used.
+\item[\np{nn\_eos}\forcode{ = 0}] the polyEOS80-bsq equation of seawater is used.
 It takes the same polynomial form as the polyTEOS10, but the coefficients have been optimized
 to accurately fit EOS80 (Roquet, personal comm.). The state variables used in both the EOS80
 …
 value, the TEOS10 value.
 \item[\np{nn_eos}$=1$] a simplified EOS (S-EOS) inspired by \citet{Vallis06} is chosen,
+\item[\np{nn\_eos}\forcode{ = 1}] a simplified EOS (S-EOS) inspired by \citet{Vallis06} is chosen,
 the coefficients of which has been optimized to fit the behavior of TEOS10 (Roquet, personal comm.)
 (see also \citet{Roquet_JPO2015}). It provides a simplistic linear representation of both
 …
 \hline
 coeff.   & computer name   & S-EOS     &  description                      \\ \hline
 $a_0$       & \np{rn_a0}     & 1.6550 $10^{-1}$ &  linear thermal expansion coeff.  \\ \hline
 $b_0$       & \np{rn_b0}      & 7.6554 $10^{-1}$ &  linear haline  expansion coeff.    \\ \hline
 $\lambda_1$ & \np{rn_lambda1}& 5.9520 $10^{-2}$ &  cabbeling coeff. in $T^2$        \\ \hline
 $\lambda_2$ & \np{rn_lambda2}& 5.4914 $10^{-4}$ &  cabbeling coeff. in $S^2$        \\ \hline
 $\nu$       & \np{rn_nu}     & 2.4341 $10^{-3}$ &  cabbeling coeff. in $T \, S$     \\ \hline
 $\mu_1$     & \np{rn_mu1}  & 1.4970 $10^{-4}$ &  thermobaric coeff. in T         \\ \hline
 $\mu_2$     & \np{rn_mu2}  & 1.1090 $10^{-5}$ &  thermobaric coeff. in S            \\ \hline
+$a_0$       & \np{rn\_a0}     & 1.6550 $10^{-1}$ &  linear thermal expansion coeff.    \\ \hline
+$b_0$       & \np{rn\_b0}     & 7.6554 $10^{-1}$ &  linear haline  expansion coeff.    \\ \hline
+$\lambda_1$ & \np{rn\_lambda1}& 5.9520 $10^{-2}$ &  cabbeling coeff. in $T^2$          \\ \hline
+$\lambda_2$ & \np{rn\_lambda2}& 5.4914 $10^{-4}$ &  cabbeling coeff. in $S^2$       \\ \hline
+$\nu$       & \np{rn\_nu}     & 2.4341 $10^{-3}$ &  cabbeling coeff. in $T \, S$       \\ \hline
+$\mu_1$     & \np{rn\_mu1}    & 1.4970 $10^{-4}$ &  thermobaric coeff. in T         \\ \hline
+$\mu_2$     & \np{rn\_mu2}    & 1.1090 $10^{-5}$ &  thermobaric coeff. in S            \\ \hline
 \end{tabular}
 \caption{ \protect\label{Tab_SEOS}
 …
 %        Brunt-V\"{a}is\"{a}l\"{a} Frequency
 % -------------------------------------------------------------------------------------------------------------
 \subsection{Brunt-V\"{a}is\"{a}l\"{a} Frequency (\protect\np{nn_eos} = 0, 1 or 2)}
+\subsection{Brunt-V\"{a}is\"{a}l\"{a} frequency (\protect\np{nn\_eos}\forcode{ = 0..2})}
 \label{TRA_bn2}
 …
 %        Freezing Point of Seawater
 % -------------------------------------------------------------------------------------------------------------
+\subsection   [Freezing Point of Seawater]
+         {Freezing Point of Seawater}
+\subsection{Freezing point of seawater}
 \label{TRA_fzp}
 …
 % Horizontal Derivative in zps-coordinate
 % ================================================================
+\section  [Horizontal Derivative in \textit{zps}-coordinate (\textit{zpshde})]
+      {Horizontal Derivative in \textit{zps}-coordinate (\protect\mdl{zpshde})}
+\section{Horizontal derivative in \textit{zps}-coordinate (\protect\mdl{zpshde})}
 \label{TRA_zpshde}
 …
                    I've changed "derivative" to "difference" and "mean" to "average"}
 With partial cells (\forcode{ln_zps = .true.}) at bottom and top (\forcode{ln_isfcav = .true.}), in general,
+With partial cells (\np{ln\_zps}\forcode{ = .true.}) at bottom and top (\np{ln\_isfcav}\forcode{ = .true.}), in general,
 tracers in horizontally adjacent cells live at different depths.
 Horizontal gradients of tracers are needed for horizontal diffusion (\mdl{traldf} module)
 and the hydrostatic pressure gradient calculations (\mdl{dynhpg} module).
 The partial cell properties at the top (\forcode{ln_isfcav = .true.}) are computed in the same way as for the bottom.
+The partial cell properties at the top (\np{ln\_isfcav}\forcode{ = .true.}) are computed in the same way as for the bottom.
 So, only the bottom interpolation is explained below.
 …
 \caption{   \protect\label{Fig_Partial_step_scheme}
 Discretisation of the horizontal difference and average of tracers in the $z$-partial
 step coordinate (\protect\forcode{ln_zps = .true.}) in the case $( e3w_k^{i+1} - e3w_k^i  )>0$.
+step coordinate (\np{ln\_zps}\forcode{ = .true.}) in the case $( e3w_k^{i+1} - e3w_k^i  )>0$.
 A linear interpolation is used to estimate $\widetilde{T}_k^{i+1}$, the tracer value
 at the depth of the shallower tracer point of the two adjacent bottom $T$-points.

branches/2017/dev_merge_2017/DOC/tex_sub/chap_ZDF.tex

-                      r9392
+                      r9393
 % Vertical Mixing
 % ================================================================
 \section{Vertical Mixing}
+\section{Vertical mixing}
 \label{ZDF_zdf}
 …
 general trend in the \mdl{dynzdf} and \mdl{trazdf} modules, respectively.
 These trends can be computed using either a forward time stepping scheme
 (namelist parameter \forcode{ln_zdfexp = .true.}) or a backward time stepping
 scheme (\forcode{ln_zdfexp = .false.}) depending on the magnitude of the mixing
+(namelist parameter \np{ln\_zdfexp}\forcode{ = .true.}) or a backward time stepping
+scheme (\np{ln\_zdfexp}\forcode{ = .false.}) depending on the magnitude of the mixing
 coefficients, and thus of the formulation used (see \S\ref{STP}).
 …
 \end{align*}
 These values are set through the \np{rn_avm0} and \np{rn_avt0} namelist parameters.
+These values are set through the \np{rn\_avm0} and \np{rn\_avt0} namelist parameters.
 In all cases, do not use values smaller that those associated with the molecular
 viscosity and diffusivity, that is $\sim10^{-6}~m^2.s^{-1}$ for momentum,
 …
 %        Richardson Number Dependent
 % -------------------------------------------------------------------------------------------------------------
 \subsection{Richardson Number Dependent (\protect\key{zdfric})}
+\subsection{Richardson number dependent (\protect\key{zdfric})}
 \label{ZDF_ric}
 …
 is the maximum value that can be reached by the coefficient when $Ri\leq 0$,
 $a=5$ and $n=2$. The last three values can be modified by setting the
 \np{rn_avmri}, \np{rn_alp} and \np{nn_ric} namelist parameters, respectively.
+\np{rn\_avmri}, \np{rn\_alp} and \np{nn\_ric} namelist parameters, respectively.
 A simple mixing-layer model to transfer and dissipate the atmospheric
  forcings (wind-stress and buoyancy fluxes) can be activated setting
 the \np{ln_mldw} =.true. in the namelist.
+the \np{ln\_mldw}\forcode{ = .true.} in the namelist.
 In this case, the local depth of turbulent wind-mixing or "Ekman depth"
 …
 is computed from the wind stress vector $|\tau|$ and the reference density $ \rho_o$.
 The final $h_{e}$ is further constrained by the adjustable bounds \np{rn_mldmin} and \np{rn_mldmax}.
+The final $h_{e}$ is further constrained by the adjustable bounds \np{rn\_mldmin} and \np{rn\_mldmax}.
 Once $h_{e}$ is computed, the vertical eddy coefficients within $h_{e}$ are set to
 the empirical values \np{rn_wtmix} and \np{rn_wvmix} \citep{Lermusiaux2001}.
+the empirical values \np{rn\_wtmix} and \np{rn\_wvmix} \citep{Lermusiaux2001}.
 % -------------------------------------------------------------------------------------------------------------
 %        TKE Turbulent Closure Scheme
 % -------------------------------------------------------------------------------------------------------------
 \subsection{TKE Turbulent Closure Scheme (\protect\key{zdftke})}
+\subsection{TKE turbulent closure scheme (\protect\key{zdftke})}
 \label{ZDF_tke}
 …
 and diffusivity coefficients. The constants $C_k =  0.1$ and $C_\epsilon = \sqrt {2} /2$
 $\approx 0.7$ are designed to deal with vertical mixing at any depth \citep{Gaspar1990}.
 They are set through namelist parameters \np{nn_ediff} and \np{nn_ediss}.
+They are set through namelist parameters \np{nn\_ediff} and \np{nn\_ediss}.
 $P_{rt}$ can be set to unity or, following \citet{Blanke1993}, be a function
 of the local Richardson number, $R_i$:
 …
 \end{align*}
 Options are defined through the  \ngn{namzdfy\_tke} namelist variables.
 The choice of $P_{rt}$ is controlled by the \np{nn_pdl} namelist variable.
+The choice of $P_{rt}$ is controlled by the \np{nn\_pdl} namelist variable.
 At the sea surface, the value of $\bar{e}$ is prescribed from the wind
 stress field as $\bar{e}_o = e_{bb} |\tau| / \rho_o$, with $e_{bb}$ the \np{rn_ebb}
+stress field as $\bar{e}_o = e_{bb} |\tau| / \rho_o$, with $e_{bb}$ the \np{rn\_ebb}
 namelist parameter. The default value of $e_{bb}$ is 3.75. \citep{Gaspar1990}),
 however a much larger value can be used when taking into account the
 …
 The time integration of the $\bar{e}$ equation may formally lead to negative values
 because the numerical scheme does not ensure its positivity. To overcome this
 problem, a cut-off in the minimum value of $\bar{e}$ is used (\np{rn_emin}
+problem, a cut-off in the minimum value of $\bar{e}$ is used (\np{rn\_emin}
 namelist parameter). Following \citet{Gaspar1990}, the cut-off value is set
 to $\sqrt{2}/2~10^{-6}~m^2.s^{-2}$. This allows the subsequent formulations
 …
 instabilities associated with too weak vertical diffusion. They must be
 specified at least larger than the molecular values, and are set through
 \np{rn_avm0} and \np{rn_avt0} (namzdf namelist, see \S\ref{ZDF_cst}).
+\np{rn\_avm0} and \np{rn\_avt0} (namzdf namelist, see \S\ref{ZDF_cst}).
 \subsubsection{Turbulent length scale}
 For computational efficiency, the original formulation of the turbulent length
 scales proposed by \citet{Gaspar1990} has been simplified. Four formulations
 are proposed, the choice of which is controlled by the \np{nn_mxl} namelist
+are proposed, the choice of which is controlled by the \np{nn\_mxl} namelist
 parameter. The first two are based on the following first order approximation
 \citep{Blanke1993}:
 …
 which is valid in a stable stratified region with constant values of the Brunt-
 Vais\"{a}l\"{a} frequency. The resulting length scale is bounded by the distance
 to the surface or to the bottom (\np{nn_mxl} = 0) or by the local vertical scale factor
 (\np{nn_mxl} = 1). \citet{Blanke1993} notice that this simplification has two major
+to the surface or to the bottom (\np{nn\_mxl}\forcode{ = 0}) or by the local vertical scale factor
+(\np{nn\_mxl}\forcode{ = 1}). \citet{Blanke1993} notice that this simplification has two major
 drawbacks: it makes no sense for locally unstable stratification and the
 computation no longer uses all the information contained in the vertical density
 profile. To overcome these drawbacks, \citet{Madec1998} introduces the
 \np{nn_mxl} = 2 or 3 cases, which add an extra assumption concerning the vertical
+\np{nn\_mxl}\forcode{ = 2..3} cases, which add an extra assumption concerning the vertical
 gradient of the computed length scale. So, the length scales are first evaluated
 as in \eqref{Eq_tke_mxl0_1} and then bounded such that:
 …
 $i.e.$ $l^{(k)} = \sqrt {2 {\bar e}^{(k)} / {N^2}^{(k)} }$.
 In the \np{nn_mxl}~=~2 case, the dissipation and mixing length scales take the same
+In the \np{nn\_mxl}\forcode{ = 2} case, the dissipation and mixing length scales take the same
 value: $ l_k=  l_\epsilon = \min \left(\ l_{up} \;,\;  l_{dwn}\ \right)$, while in the
 \np{nn_mxl}~=~3 case, the dissipation and mixing turbulent length scales are give
+\np{nn\_mxl}\forcode{ = 3} case, the dissipation and mixing turbulent length scales are give
 as in \citet{Gaspar1990}:
 \begin{equation} \label{Eq_tke_mxl_gaspar}
 …
 \end{equation}
 At the ocean surface, a non zero length scale is set through the  \np{rn_mxl0} namelist
+At the ocean surface, a non zero length scale is set through the  \np{rn\_mxl0} namelist
 parameter. Usually the surface scale is given by $l_o = \kappa \,z_o$
 where $\kappa = 0.4$ is von Karman's constant and $z_o$ the roughness
 parameter of the surface. Assuming $z_o=0.1$~m \citep{Craig_Banner_JPO94}
 leads to a 0.04~m, the default value of \np{rn_mxl0}. In the ocean interior
+leads to a 0.04~m, the default value of \np{rn\_mxl0}. In the ocean interior
 a minimum length scale is set to recover the molecular viscosity when $\bar{e}$
 reach its minimum value ($1.10^{-6}= C_k\, l_{min} \,\sqrt{\bar{e}_{min}}$ ).
 …
 citing observation evidence, and $\alpha_{CB} = 100$ the Craig and Banner's value.
 As the surface boundary condition on TKE is prescribed through $\bar{e}_o = e_{bb} |\tau| / \rho_o$,
 with $e_{bb}$ the \np{rn_ebb} namelist parameter, setting \np{rn_ebb}~=~67.83 corresponds
 to $\alpha_{CB} = 100$. Further setting  \np{ln_mxl0} to true applies \eqref{ZDF_Lsbc}
+with $e_{bb}$ the \np{rn\_ebb} namelist parameter, setting \np{rn\_ebb}\forcode{ = 67.83} corresponds
+to $\alpha_{CB} = 100$. Further setting  \np{ln\_mxl0} to true applies \eqref{ZDF_Lsbc}
 as surface boundary condition on length scale, with $\beta$ hard coded to the Stacey's value.
 Note that a minimal threshold of \np{rn_emin0}$=10^{-4}~m^2.s^{-2}$ (namelist parameters)
+Note that a minimal threshold of \np{rn\_emin0}$=10^{-4}~m^2.s^{-2}$ (namelist parameters)
 is applied on surface $\bar{e}$ value.
 …
 of LC in an extra source terms of TKE, $P_{LC}$.
 The presence of $P_{LC}$ in \eqref{Eq_zdftke_e}, the TKE equation, is controlled
 by setting \np{ln_lc} to \textit{true} in the namtke namelist.
+by setting \np{ln\_lc} to \forcode{.true.} in the namtke namelist.
 By making an analogy with the characteristic convective velocity scale
 …
 where $c_{LC} = 0.15$ has been chosen by \citep{Axell_JGR02} as a good compromise
 to fit LES data. The chosen value yields maximum vertical velocities $w_{LC}$ of the order
 of a few centimeters per second. The value of $c_{LC}$ is set through the \np{rn_lc}
+of a few centimeters per second. The value of $c_{LC}$ is set through the \np{rn\_lc}
 namelist parameter, having in mind that it should stay between 0.15 and 0.54 \citep{Axell_JGR02}.
 …
 ($i.e.$ near-inertial oscillations and ocean swells and waves).
 When using this parameterization ($i.e.$ when \np{nn_etau}~=~1), the TKE input to the ocean ($S$)
+When using this parameterization ($i.e.$ when \np{nn\_etau}\forcode{ = 1}), the TKE input to the ocean ($S$)
 imposed by the winds in the form of near-inertial oscillations, swell and waves is parameterized
 by \eqref{ZDF_Esbc} the standard TKE surface boundary condition, plus a depth depend one given by:
 …
 and $f_i$ is the ice concentration (no penetration if $f_i=1$, that is if the ocean is entirely
 covered by sea-ice).
 The value of $f_r$, usually a few percents, is specified through \np{rn_efr} namelist parameter.
 The vertical mixing length scale, $h_\tau$, can be set as a 10~m uniform value (\np{nn_etau}~=~0)
+The value of $f_r$, usually a few percents, is specified through \np{rn\_efr} namelist parameter.
+The vertical mixing length scale, $h_\tau$, can be set as a 10~m uniform value (\np{nn\_etau}\forcode{ = 0})
 or a latitude dependent value (varying from 0.5~m at the Equator to a maximum value of 30~m
 at high latitudes (\np{nn_etau}~=~1).
 Note that two other option existe, \np{nn_etau}~=~2, or 3. They correspond to applying
+at high latitudes (\np{nn\_etau}\forcode{ = 1}).
+Note that two other option existe, \np{nn\_etau}\forcode{ = 2..3}. They correspond to applying
 \eqref{ZDF_Ehtau} only at the base of the mixed layer, or to using the high frequency part
 of the stress to evaluate the fraction of TKE that penetrate the ocean.
 …
 %        GLS Generic Length Scale Scheme
 % -------------------------------------------------------------------------------------------------------------
 \subsection{GLS Generic Length Scale (\protect\key{zdfgls})}
+\subsection{GLS: Generic Length Scale (\protect\key{zdfgls})}
 \label{ZDF_gls}
 …
 The constants $C_1$, $C_2$, $C_3$, ${\sigma_e}$, ${\sigma_{\psi}}$ and the wall function ($Fw$)
 depends of the choice of the turbulence model. Four different turbulent models are pre-defined
 (Tab.\ref{Tab_GLS}). They are made available through the \np{nn_clo} namelist parameter.
+(Tab.\ref{Tab_GLS}). They are made available through the \np{nn\_clo} namelist parameter.
 %--------------------------------------------------TABLE--------------------------------------------------
 …
 %                        & \citep{Mellor_Yamada_1982} &  \citep{Rodi_1987}       & \citep{Wilcox_1988} &                 \\
 \hline  \hline
 \np{nn_clo}     & \textbf{0} &   \textbf{1}  &   \textbf{2}   &    \textbf{3}   \\
+\np{nn\_clo}     & \textbf{0} &   \textbf{1}  &   \textbf{2}   &    \textbf{3}   \\
 \hline
 $( p , n , m )$          &   ( 0 , 1 , 1 )   & ( 3 , 1.5 , -1 )   & ( -1 , 0.5 , -1 )    &  ( 2 , 1 , -0.67 )  \\
 …
 \caption{   \protect\label{Tab_GLS}
 Set of predefined GLS parameters, or equivalently predefined turbulence models available
 with \protect\key{zdfgls} and controlled by the \protect\np{nn_clos} namelist variable in \protect\ngn{namzdf\_gls} .}
+with \protect\key{zdfgls} and controlled by the \protect\np{nn\_clos} namelist variable in \protect\ngn{namzdf\_gls} .}
 \end{center}   \end{table}
 %--------------------------------------------------------------------------------------------------------------
 …
 value near physical boundaries (logarithmic boundary layer law). $C_{\mu}$ and $C_{\mu'}$
 are calculated from stability function proposed by \citet{Galperin_al_JAS88}, or by \citet{Kantha_Clayson_1994}
 or one of the two functions suggested by \citet{Canuto_2001}  (\np{nn_stab_func} = 0, 1, 2 or 3, resp.).
+or one of the two functions suggested by \citet{Canuto_2001}  (\np{nn\_stab\_func}\forcode{ = 0..3}, resp.).
 The value of $C_{0\mu}$ depends of the choice of the stability function.
 The surface and bottom boundary condition on both $\bar{e}$ and $\psi$ can be calculated
 thanks to Dirichlet or Neumann condition through \np{nn_tkebc_surf} and \np{nn_tkebc_bot}, resp.
 As for TKE closure , the wave effect on the mixing is considered when \np{ln_crban}~=~true
 \citep{Craig_Banner_JPO94, Mellor_Blumberg_JPO04}. The \np{rn_crban} namelist parameter
 is $\alpha_{CB}$ in \eqref{ZDF_Esbc} and \np{rn_charn} provides the value of $\beta$ in \eqref{ZDF_Lsbc}.
+thanks to Dirichlet or Neumann condition through \np{nn\_tkebc\_surf} and \np{nn\_tkebc\_bot}, resp.
+As for TKE closure , the wave effect on the mixing is considered when \np{ln\_crban}\forcode{ = .true.}
+\citep{Craig_Banner_JPO94, Mellor_Blumberg_JPO04}. The \np{rn\_crban} namelist parameter
+is $\alpha_{CB}$ in \eqref{ZDF_Esbc} and \np{rn\_charn} provides the value of $\beta$ in \eqref{ZDF_Lsbc}.
 The $\psi$ equation is known to fail in stably stratified flows, and for this reason
 …
 stably stratified situations, and that its value has to be chosen in accordance
 with the algebraic model for the turbulent fluxes. The clipping is only activated
 if \forcode{ln_length_lim = .true.}, and the $c_{lim}$ is set to the \np{rn_clim_galp} value.
+if \np{ln\_length\_lim}\forcode{ = .true.}, and the $c_{lim}$ is set to the \np{rn\_clim\_galp} value.
 The time and space discretization of the GLS equations follows the same energetic
 …
 %        OSM OSMOSIS BL Scheme
 % -------------------------------------------------------------------------------------------------------------
 \subsection{OSM OSMOSIS Boundary Layer scheme (\protect\key{zdfosm})}
+\subsection{OSM: OSMOSIS boundary layer scheme (\protect\key{zdfosm})}
 \label{ZDF_osm}
 …
 %       Non-Penetrative Convective Adjustment
 % -------------------------------------------------------------------------------------------------------------
 \subsection   [Non-Penetrative Convective Adjustment (\protect\np{ln_tranpc}) ]
          {Non-Penetrative Convective Adjustment (\protect\np{ln_tranpc}=.true.) }
+\subsection[Non-penetrative convective adjmt (\protect\np{ln\_tranpc}\forcode{ = .true.})]
+            {Non-penetrative convective adjustment (\protect\np{ln\_tranpc}\forcode{ = .true.})}
 \label{ZDF_npc}
 …
 Options are defined through the  \ngn{namzdf} namelist variables.
 The non-penetrative convective adjustment is used when \np{ln_zdfnpc}~=~\textit{true}.
 It is applied at each \np{nn_npc} time step and mixes downwards instantaneously
+The non-penetrative convective adjustment is used when \np{ln\_zdfnpc}\forcode{ = .true.}.
+It is applied at each \np{nn\_npc} time step and mixes downwards instantaneously
 the statically unstable portion of the water column, but only until the density
 structure becomes neutrally stable ($i.e.$ until the mixed portion of the water
 …
 %       Enhanced Vertical Diffusion
 % -------------------------------------------------------------------------------------------------------------
+\subsection   [Enhanced Vertical Diffusion (\protect\np{ln_zdfevd})]
+              {Enhanced Vertical Diffusion (\protect\forcode{ln_zdfevd = .true.})}
+\subsection{Enhanced vertical diffusion (\protect\np{ln\_zdfevd}\forcode{ = .true.})}
 \label{ZDF_evd}
 …
 Options are defined through the  \ngn{namzdf} namelist variables.
 The enhanced vertical diffusion parameterisation is used when \forcode{ln_zdfevd = .true.}.
+The enhanced vertical diffusion parameterisation is used when \np{ln\_zdfevd}\forcode{ = .true.}.
 In this case, the vertical eddy mixing coefficients are assigned very large values
 (a typical value is $10\;m^2s^{-1})$ in regions where the stratification is unstable
 ($i.e.$ when $N^2$ the Brunt-Vais\"{a}l\"{a} frequency is negative)
 \citep{Lazar_PhD97, Lazar_al_JPO99}. This is done either on tracers only
 (\forcode{nn_evdm = 0}) or on both momentum and tracers (\forcode{nn_evdm = 1}).

New URL for NEMO forge! http://forge.nemo-ocean.eu

Context Navigation

Legend:

branches/2017/dev_merge_2017/DOC/build_NEMO_manual.sh

branches/2017/dev_merge_2017/DOC/clean.sh

branches/2017/dev_merge_2017/DOC/tex_main/NEMO_manual.sty

branches/2017/dev_merge_2017/DOC/tex_main/NEMO_manual.tex

branches/2017/dev_merge_2017/DOC/tex_sub/abstract_foreword.tex

branches/2017/dev_merge_2017/DOC/tex_sub/annex_A.tex

branches/2017/dev_merge_2017/DOC/tex_sub/annex_B.tex

branches/2017/dev_merge_2017/DOC/tex_sub/annex_C.tex

branches/2017/dev_merge_2017/DOC/tex_sub/annex_D.tex

branches/2017/dev_merge_2017/DOC/tex_sub/annex_E.tex

branches/2017/dev_merge_2017/DOC/tex_sub/annex_iso.tex

branches/2017/dev_merge_2017/DOC/tex_sub/chap_ASM.tex

branches/2017/dev_merge_2017/DOC/tex_sub/chap_CONFIG.tex

branches/2017/dev_merge_2017/DOC/tex_sub/chap_DIA.tex

branches/2017/dev_merge_2017/DOC/tex_sub/chap_DIU.tex

branches/2017/dev_merge_2017/DOC/tex_sub/chap_DOM.tex

branches/2017/dev_merge_2017/DOC/tex_sub/chap_DYN.tex

branches/2017/dev_merge_2017/DOC/tex_sub/chap_LBC.tex

branches/2017/dev_merge_2017/DOC/tex_sub/chap_LDF.tex

branches/2017/dev_merge_2017/DOC/tex_sub/chap_OBS.tex

branches/2017/dev_merge_2017/DOC/tex_sub/chap_SBC.tex

branches/2017/dev_merge_2017/DOC/tex_sub/chap_STO.tex

branches/2017/dev_merge_2017/DOC/tex_sub/chap_TRA.tex

branches/2017/dev_merge_2017/DOC/tex_sub/chap_ZDF.tex