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

Since March 2022 along with NEMO 4.2 release, the code development moved to a self-hosted GitLab.
This present forge is now archived and remained online for history.
Changeset 9407 for branches/2017/dev_merge_2017/DOC/tex_sub/chap_LDF.tex – NEMO

Ignore:
Timestamp:
2018-03-15T17:40:35+01:00 (6 years ago)
Author:
nicolasmartin
Message:

Complete refactoring of cross-referencing

  • Use of \autoref instead of simple \ref for contextual text depending on target type
  • creation of few prefixes for marker to identify the type reference: apdx|chap|eq|fig|sec|subsec|tab
File:
1 edited

Legend:

Unmodified
Added
Removed
  • branches/2017/dev_merge_2017/DOC/tex_sub/chap_LDF.tex

    r9394 r9407  
    66% ================================================================ 
    77\chapter{Lateral Ocean Physics (LDF)} 
    8 \label{LDF} 
     8\label{chap:LDF} 
    99\minitoc 
    1010 
     
    1515 
    1616The lateral physics terms in the momentum and tracer equations have been  
    17 described in \S\ref{PE_zdf} and their discrete formulation in \S\ref{TRA_ldf}  
    18 and \S\ref{DYN_ldf}). In this section we further discuss each lateral physics option.  
     17described in \autoref{eq:PE_zdf} and their discrete formulation in \autoref{sec:TRA_ldf}  
     18and \autoref{sec:DYN_ldf}). In this section we further discuss each lateral physics option.  
    1919Choosing one lateral physics scheme means for the user defining,  
    2020(1) the type of operator used (laplacian or bilaplacian operators, or no lateral mixing term) ;  
     
    2525Note that this chapter describes the standard implementation of iso-neutral 
    2626tracer mixing, and Griffies's implementation, which is used if 
    27 \np{traldf\_grif}\forcode{ = .true.}, is described in Appdx\ref{sec:triad} 
     27\np{traldf\_grif}\forcode{ = .true.}, is described in Appdx\autoref{apdx:triad} 
    2828 
    2929%-----------------------------------nam_traldf - nam_dynldf-------------------------------------------- 
     
    3737% ================================================================ 
    3838\section{Direction of lateral mixing (\protect\mdl{ldfslp})} 
    39 \label{LDF_slp} 
     39\label{sec:LDF_slp} 
    4040 
    4141%%% 
     
    5050slopes in the \textbf{i}- and \textbf{j}-directions at the face of the cell of the  
    5151quantity to be diffused. For a tracer, this leads to the following four slopes :  
    52 $r_{1u}$, $r_{1w}$, $r_{2v}$, $r_{2w}$ (see \eqref{Eq_tra_ldf_iso}), while  
     52$r_{1u}$, $r_{1w}$, $r_{2v}$, $r_{2w}$ (see \autoref{eq:tra_ldf_iso}), while  
    5353for momentum the slopes are  $r_{1t}$, $r_{1uw}$, $r_{2f}$, $r_{2uw}$ for  
    5454$u$ and  $r_{1f}$, $r_{1vw}$, $r_{2t}$, $r_{2vw}$ for $v$.  
     
    6060In $s$-coordinates, geopotential mixing ($i.e.$ horizontal mixing) $r_1$ and  
    6161$r_2$ are the slopes between the geopotential and computational surfaces.  
    62 Their discrete formulation is found by locally solving \eqref{Eq_tra_ldf_iso}  
     62Their discrete formulation is found by locally solving \autoref{eq:tra_ldf_iso}  
    6363when the diffusive fluxes in the three directions are set to zero and $T$ is  
    6464assumed to be horizontally uniform, $i.e.$ a linear function of $z_T$, the  
     
    6666%gm { Steven : My version is obviously wrong since I'm left with an arbitrary constant which is the local vertical temperature gradient} 
    6767 
    68 \begin{equation} \label{Eq_ldfslp_geo} 
     68\begin{equation} \label{eq:ldfslp_geo} 
    6969\begin{aligned} 
    7070 r_{1u} &= \frac{e_{3u}}{ \left( e_{1u}\;\overline{\overline{e_{3w}}}^{\,i+1/2,\,k} \right)} 
     
    9191 
    9292\subsection{Slopes for tracer iso-neutral mixing} 
    93 \label{LDF_slp_iso} 
     93\label{subsec:LDF_slp_iso} 
    9494In iso-neutral mixing  $r_1$ and $r_2$ are the slopes between the iso-neutral  
    9595and computational surfaces. Their formulation does not depend on the vertical  
    9696coordinate used. Their discrete formulation is found using the fact that the  
    9797diffusive fluxes of locally referenced potential density ($i.e.$ $in situ$ density)  
    98 vanish. So, substituting $T$ by $\rho$ in \eqref{Eq_tra_ldf_iso} and setting the  
     98vanish. So, substituting $T$ by $\rho$ in \autoref{eq:tra_ldf_iso} and setting the  
    9999diffusive fluxes in the three directions to zero leads to the following definition for  
    100100the neutral slopes: 
    101101 
    102 \begin{equation} \label{Eq_ldfslp_iso} 
     102\begin{equation} \label{eq:ldfslp_iso} 
    103103\begin{split} 
    104104 r_{1u} &= \frac{e_{3u}}{e_{1u}}\; \frac{\delta_{i+1/2}[\rho]} 
     
    120120 
    121121%gm% rewrite this as the explanation is not very clear !!! 
    122 %In practice, \eqref{Eq_ldfslp_iso} is of little help in evaluating the neutral surface slopes. Indeed, for an unsimplified equation of state, the density has a strong dependancy on pressure (here approximated as the depth), therefore applying \eqref{Eq_ldfslp_iso} using the $in situ$ density, $\rho$, computed at T-points leads to a flattening of slopes as the depth increases. This is due to the strong increase of the $in situ$ density with depth.  
    123  
    124 %By definition, neutral surfaces are tangent to the local $in situ$ density \citep{McDougall1987}, therefore in \eqref{Eq_ldfslp_iso}, all the derivatives have to be evaluated at the same local pressure (which in decibars is approximated by the depth in meters). 
    125  
    126 %In the $z$-coordinate, the derivative of the  \eqref{Eq_ldfslp_iso} numerator is evaluated at the same depth \nocite{as what?} ($T$-level, which is the same as the $u$- and $v$-levels), so  the $in situ$ density can be used for its evaluation.  
     122%In practice, \autoref{eq:ldfslp_iso} is of little help in evaluating the neutral surface slopes. Indeed, for an unsimplified equation of state, the density has a strong dependancy on pressure (here approximated as the depth), therefore applying \autoref{eq:ldfslp_iso} using the $in situ$ density, $\rho$, computed at T-points leads to a flattening of slopes as the depth increases. This is due to the strong increase of the $in situ$ density with depth.  
     123 
     124%By definition, neutral surfaces are tangent to the local $in situ$ density \citep{McDougall1987}, therefore in \autoref{eq:ldfslp_iso}, all the derivatives have to be evaluated at the same local pressure (which in decibars is approximated by the depth in meters). 
     125 
     126%In the $z$-coordinate, the derivative of the  \autoref{eq:ldfslp_iso} numerator is evaluated at the same depth \nocite{as what?} ($T$-level, which is the same as the $u$- and $v$-levels), so  the $in situ$ density can be used for its evaluation.  
    127127 
    128128As the mixing is performed along neutral surfaces, the gradient of $\rho$ in  
    129 \eqref{Eq_ldfslp_iso} has to be evaluated at the same local pressure (which,  
     129\autoref{eq:ldfslp_iso} has to be evaluated at the same local pressure (which,  
    130130in decibars, is approximated by the depth in meters in the model). Therefore  
    131 \eqref{Eq_ldfslp_iso} cannot be used as such, but further transformation is  
     131\autoref{eq:ldfslp_iso} cannot be used as such, but further transformation is  
    132132needed depending on the vertical coordinate used: 
    133133 
    134134\begin{description} 
    135135 
    136 \item[$z$-coordinate with full step : ] in \eqref{Eq_ldfslp_iso} the densities  
     136\item[$z$-coordinate with full step : ] in \autoref{eq:ldfslp_iso} the densities  
    137137appearing in the $i$ and $j$ derivatives  are taken at the same depth, thus  
    138138the $in situ$ density can be used. This is not the case for the vertical  
    139139derivatives: $\delta_{k+1/2}[\rho]$ is replaced by $-\rho N^2/g$, where $N^2$  
    140140is the local Brunt-Vais\"{a}l\"{a} frequency evaluated following  
    141 \citet{McDougall1987} (see \S\ref{TRA_bn2}).  
     141\citet{McDougall1987} (see \autoref{subsec:TRA_bn2}).  
    142142 
    143143\item[$z$-coordinate with partial step : ] this case is identical to the full step  
    144144case except that at partial step level, the \emph{horizontal} density gradient  
    145 is evaluated as described in \S\ref{TRA_zpshde}. 
     145is evaluated as described in \autoref{sec:TRA_zpshde}. 
    146146 
    147147\item[$s$- or hybrid $s$-$z$- coordinate : ] in the current release of \NEMO,  
    148148iso-neutral mixing is only employed for $s$-coordinates if the 
    149 Griffies scheme is used (\np{traldf\_grif}\forcode{ = .true.}; see Appdx \ref{sec:triad}).  
     149Griffies scheme is used (\np{traldf\_grif}\forcode{ = .true.}; see Appdx \autoref{apdx:triad}).  
    150150In other words, iso-neutral mixing will only be accurately represented with a  
    151151linear equation of state (\np{nn\_eos}\forcode{ = 1..2}). In the case of a "true" equation  
    152 of state, the evaluation of $i$ and $j$ derivatives in \eqref{Eq_ldfslp_iso}  
     152of state, the evaluation of $i$ and $j$ derivatives in \autoref{eq:ldfslp_iso}  
    153153will include a pressure dependent part, leading to the wrong evaluation of  
    154154the neutral slopes. 
     
    168168This constraint leads to the following definition for the slopes: 
    169169 
    170 \begin{equation} \label{Eq_ldfslp_iso2} 
     170\begin{equation} \label{eq:ldfslp_iso2} 
    171171\begin{split} 
    172172 r_{1u} &= \frac{e_{3u}}{e_{1u}}\; \frac 
     
    193193\end{equation} 
    194194where $\alpha$ and $\beta$, the thermal expansion and saline contraction  
    195 coefficients introduced in \S\ref{TRA_bn2}, have to be evaluated at the three  
     195coefficients introduced in \autoref{subsec:TRA_bn2}, have to be evaluated at the three  
    196196velocity points. In order to save computation time, they should be approximated  
    197197by the mean of their values at $T$-points (for example in the case of $\alpha$:   
     
    212212ocean model are modified \citep{Weaver_Eby_JPO97, 
    213213  Griffies_al_JPO98}. Griffies's scheme is now available in \NEMO if 
    214 \np{traldf\_grif\_iso} is set true; see Appdx \ref{sec:triad}. Here, 
     214\np{traldf\_grif\_iso} is set true; see Appdx \autoref{apdx:triad}. Here, 
    215215another strategy is presented \citep{Lazar_PhD97}: a local 
    216216filtering of the iso-neutral slopes (made on 9 grid-points) prevents 
    217217the development of grid point noise generated by the iso-neutral 
    218 diffusion operator (Fig.~\ref{Fig_LDF_ZDF1}). This allows an 
     218diffusion operator (\autoref{fig:LDF_ZDF1}). This allows an 
    219219iso-neutral diffusion scheme without additional background horizontal 
    220220mixing. This technique can be viewed as a diffusion operator that acts 
     
    231231\begin{figure}[!ht]      \begin{center} 
    232232\includegraphics[width=0.70\textwidth]{Fig_LDF_ZDF1} 
    233 \caption {    \protect\label{Fig_LDF_ZDF1} 
     233\caption {    \protect\label{fig:LDF_ZDF1} 
    234234averaging procedure for isopycnal slope computation.} 
    235235\end{center}    \end{figure} 
     
    259259\begin{figure}[!ht]     \begin{center} 
    260260\includegraphics[width=0.70\textwidth]{Fig_eiv_slp} 
    261 \caption {     \protect\label{Fig_eiv_slp} 
     261\caption {     \protect\label{fig:eiv_slp} 
    262262Vertical profile of the slope used for lateral mixing in the mixed layer :  
    263263\textit{(a)} in the real ocean the slope is the iso-neutral slope in the ocean interior,  
     
    280280The iso-neutral diffusion operator on momentum is the same as the one used on  
    281281tracers but applied to each component of the velocity separately (see  
    282 \eqref{Eq_dyn_ldf_iso} in section~\ref{DYN_ldf_iso}). The slopes between the  
     282\autoref{eq:dyn_ldf_iso} in section~\autoref{subsec:DYN_ldf_iso}). The slopes between the  
    283283surface along which the diffusion operator acts and the surface of computation  
    284284($z$- or $s$-surfaces) are defined at $T$-, $f$-, and \textit{uw}- points for the  
    285285$u$-component, and $T$-, $f$- and \textit{vw}- points for the $v$-component.  
    286286They are computed from the slopes used for tracer diffusion, $i.e.$  
    287 \eqref{Eq_ldfslp_geo} and \eqref{Eq_ldfslp_iso} : 
    288  
    289 \begin{equation} \label{Eq_ldfslp_dyn} 
     287\autoref{eq:ldfslp_geo} and \autoref{eq:ldfslp_iso} : 
     288 
     289\begin{equation} \label{eq:ldfslp_dyn} 
    290290\begin{aligned} 
    291291&r_{1t}\ \ = \overline{r_{1u}}^{\,i}       &&&    r_{1f}\ \ &= \overline{r_{1u}}^{\,i+1/2} \\ 
     
    300300diffusion along model level surfaces, i.e. using the shear computed along  
    301301the model levels and with no additional friction at the ocean bottom (see  
    302 \S\ref{LBC_coast}). 
     302\autoref{sec:LBC_coast}). 
    303303 
    304304 
     
    307307% ================================================================ 
    308308\section{Lateral mixing operators (\protect\mdl{traldf}, \protect\mdl{traldf}) } 
    309 \label{LDF_op} 
     309\label{sec:LDF_op} 
    310310 
    311311 
     
    315315% ================================================================ 
    316316\section{Lateral mixing coefficient (\protect\mdl{ldftra}, \protect\mdl{ldfdyn}) } 
    317 \label{LDF_coef} 
     317\label{sec:LDF_coef} 
    318318 
    319319Introducing a space variation in the lateral eddy mixing coefficients changes  
     
    362362By default the horizontal variation of the eddy coefficient depends on the local mesh  
    363363size and the type of operator used: 
    364 \begin{equation} \label{Eq_title} 
     364\begin{equation} \label{eq:title} 
    365365  A_l = \left\{      
    366366   \begin{aligned} 
     
    378378such as global ocean models. Indeed, in such a case, a constant mixing coefficient  
    379379can lead to a blow up of the model due to large coefficient compare to the smallest  
    380 grid size (see \S\ref{STP_forward_imp}), especially when using a bilaplacian operator. 
     380grid size (see \autoref{sec:STP_forward_imp}), especially when using a bilaplacian operator. 
    381381 
    382382Other formulations can be introduced by the user for a given configuration.  
     
    411411(1) the momentum diffusion operator acting along model level surfaces is  
    412412written in terms of curl and divergent components of the horizontal current  
    413 (see \S\ref{PE_ldf}). Although the eddy coefficient could be set to different values  
     413(see \autoref{subsec:PE_ldf}). Although the eddy coefficient could be set to different values  
    414414in these two terms, this option is not currently available.  
    415415 
     
    417417on enstrophy and on the square of the horizontal divergence for operators  
    418418acting along model-surfaces are no longer satisfied  
    419 (Appendix~\ref{Apdx_dynldf_properties}). 
     419(\autoref{sec:dynldf_properties}). 
    420420 
    421421(3) for isopycnal diffusion on momentum or tracers, an additional purely  
     
    425425values are $0$). However, the technique used to compute the isopycnal  
    426426slopes is intended to get rid of such a background diffusion, since it introduces  
    427 spurious diapycnal diffusion (see \S\ref{LDF_slp}). 
     427spurious diapycnal diffusion (see \autoref{sec:LDF_slp}). 
    428428 
    429429(4) when an eddy induced advection term is used (\key{traldf\_eiv}), $A^{eiv}$,  
     
    438438(7) it is possible to run without explicit lateral diffusion on momentum (\np{ln\_dynldf\_lap}\forcode{ =  
    439439}\np{ln\_dynldf\_bilap}\forcode{ = .false.}). This is recommended when using the UBS advection  
    440 scheme on momentum (\np{ln\_dynadv\_ubs}\forcode{ = .true.}, see \ref{DYN_adv_ubs})  
     440scheme on momentum (\np{ln\_dynadv\_ubs}\forcode{ = .true.}, see \autoref{subsec:DYN_adv_ubs})  
    441441and can be useful for testing purposes. 
    442442 
     
    445445% ================================================================ 
    446446\section{Eddy induced velocity (\protect\mdl{traadv\_eiv}, \protect\mdl{ldfeiv})} 
    447 \label{LDF_eiv} 
     447\label{sec:LDF_eiv} 
    448448 
    449449%%gm  from Triad appendix  : to be incorporated.... 
    450450\gmcomment{ 
    451451Values of iso-neutral diffusivity and GM coefficient are set as 
    452 described in \S\ref{LDF_coef}. If none of the keys \key{traldf\_cNd}, 
     452described in \autoref{sec:LDF_coef}. If none of the keys \key{traldf\_cNd}, 
    453453N=1,2,3 is set (the default), spatially constant iso-neutral $A_l$ and 
    454454GM diffusivity $A_e$ are directly set by \np{rn\_aeih\_0} and 
    455455\np{rn\_aeiv\_0}. If 2D-varying coefficients are set with 
    456456\key{traldf\_c2d} then $A_l$ is reduced in proportion with horizontal 
    457 scale factor according to \eqref{Eq_title} \footnote{Except in global ORCA 
     457scale factor according to \autoref{eq:title} \footnote{Except in global ORCA 
    458458  $0.5^{\circ}$ runs with \key{traldf\_eiv}, where 
    459459  $A_l$ is set like $A_e$ but with a minimum vale of 
     
    472472depends on the slopes of iso-neutral surfaces. Contrary to the case of iso-neutral  
    473473mixing, the slopes used here are referenced to the geopotential surfaces, $i.e.$  
    474 \eqref{Eq_ldfslp_geo} is used in $z$-coordinates, and the sum \eqref{Eq_ldfslp_geo}   
    475 + \eqref{Eq_ldfslp_iso} in $s$-coordinates. The eddy induced velocity is given by:  
    476 \begin{equation} \label{Eq_ldfeiv} 
     474\autoref{eq:ldfslp_geo} is used in $z$-coordinates, and the sum \autoref{eq:ldfslp_geo}   
     475+ \autoref{eq:ldfslp_iso} in $s$-coordinates. The eddy induced velocity is given by:  
     476\begin{equation} \label{eq:ldfeiv} 
    477477\begin{split} 
    478478 u^* & = \frac{1}{e_{2u}e_{3u}}\; \delta_k \left[e_{2u} \, A_{uw}^{eiv} \; \overline{r_{1w}}^{\,i+1/2} \right]\\ 
     
    487487separate computation of the advective trends associated with the eiv velocity,  
    488488since it allows us to take advantage of all the advection schemes offered for  
    489 the tracers (see \S\ref{TRA_adv}) and not just the $2^{nd}$ order advection  
     489the tracers (see \autoref{sec:TRA_adv}) and not just the $2^{nd}$ order advection  
    490490scheme as in previous releases of OPA \citep{Madec1998}. This is particularly  
    491491useful for passive tracers where \emph{positivity} of the advection scheme is  
Note: See TracChangeset for help on using the changeset viewer.