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 11435 for NEMO/trunk/doc/latex/NEMO/subfiles/annex_iso.tex – NEMO

Ignore:
Timestamp:
2019-08-14T14:45:08+02:00 (5 years ago)
Author:
nicolasmartin
Message:

Various corrections on chapters

Cleaning the indexes by fixing/removing wrong entries (or appending a ? to unknown items) and
improve the classification with new index definitions for CPP keys and namelist blocks:

  • from \key{...} cmd, key_ prefix no longer precedes the index entry
  • namelist block declaration moves from \ngn{nam...} to \nam{...} (i.e. \ngn{namtra\_ldf} -> \nam{tra\_ldf}) The expected prefix nam is added to the printed word but not the index entry.

Now we have indexes with a better sorting instead of all CPP keys under 'K' and namelists blocks under 'N'.

Fix missing space issues with alias commands by adding a trailing backslash (\NEMO\, \ie\, \eg\, ...).
There is no perfect solution for this, and I prefer not using a particular package to solve it.

Review the initial LaTeX code snippet for the historic changes in chapters

Finally, for readability and future diff visualisations, please avoid writing paragraphs with continuous lines.
Break the lines around 80 to 100 characters long

File:
1 edited

Legend:

Unmodified
Added
Removed
  • NEMO/trunk/doc/latex/NEMO/subfiles/annex_iso.tex

    r11187 r11435  
    1818\label{apdx:triad} 
    1919 
    20 \minitoc 
     20\chaptertoc 
    2121 
    2222\newpage 
    2323 
    24 \section{Choice of \protect\ngn{namtra\_ldf} namelist parameters} 
     24\section[Choice of \texttt{namtra\_ldf} namelist parameters] 
     25{Choice of \protect\nam{tra\_ldf} namelist parameters} 
    2526%-----------------------------------------nam_traldf------------------------------------------------------ 
    2627 
     
    3031Two scheme are available to perform the iso-neutral diffusion. 
    3132If the namelist logical \np{ln\_traldf\_triad} is set true, 
    32 \NEMO updates both active and passive tracers using the Griffies triad representation of iso-neutral diffusion and 
     33\NEMO\ updates both active and passive tracers using the Griffies triad representation of iso-neutral diffusion and 
    3334the eddy-induced advective skew (GM) fluxes. 
    3435If the namelist logical \np{ln\_traldf\_iso} is set true, 
     
    3839 
    3940Values of iso-neutral diffusivity and GM coefficient are set as described in \autoref{sec:LDF_coef}. 
    40 Note that when GM fluxes are used, the eddy-advective (GM) velocities are output for diagnostic purposes using xIOS, 
     41Note that when GM fluxes are used, the eddy-advective (GM) velocities are output for diagnostic purposes using XIOS, 
    4142even though the eddy advection is accomplished by means of the skew fluxes. 
    4243 
     
    7273\label{sec:iso} 
    7374 
    74 We have implemented into \NEMO a scheme inspired by \citet{griffies.gnanadesikan.ea_JPO98}, 
    75 but formulated within the \NEMO framework, using scale factors rather than grid-sizes. 
     75We have implemented into \NEMO\ a scheme inspired by \citet{griffies.gnanadesikan.ea_JPO98}, 
     76but formulated within the \NEMO\ framework, using scale factors rather than grid-sizes. 
    7677 
    7778\subsection{Iso-neutral diffusion operator} 
     
    191192To correct this, we introduced a smoothing of the slopes of the iso-neutral surfaces (see \autoref{chap:LDF}). 
    192193This technique works for $T$ and $S$ in so far as they are active tracers 
    193 (\ie they enter the computation of density), but it does not work for a passive tracer. 
     194(\ie\ they enter the computation of density), but it does not work for a passive tracer. 
    194195 
    195196\subsection{Expression of the skew-flux in terms of triad slopes} 
     
    280281the intersection of the $i,k$ $T$-cell, the $i+i_p,k$ $u$-cell and the $i,k+k_p$ $w$-cell. 
    281282Expressing the slopes $s_i$ and $s'_i$ in \autoref{eq:i13} and \autoref{eq:i31} in this notation, 
    282 we have \eg \ $s_1=s'_1={\:}_i^k \mathbb{R}_{1/2}^{1/2}$. 
     283we have \eg\ \ $s_1=s'_1={\:}_i^k \mathbb{R}_{1/2}^{1/2}$. 
    283284Each triad slope $_i^k\mathbb{R}_{i_p}^{k_p}$ is used once (as an $s$) to 
    284285calculate the lateral flux along its $u$-arm, at $(i+i_p,k)$, 
     
    288289and we notate these areas, similarly to the triad slopes, 
    289290as $_i^k{\mathbb{A}_u}_{i_p}^{k_p}$, $_i^k{\mathbb{A}_w}_{i_p}^{k_p}$, 
    290 where \eg in \autoref{eq:i13} $a_{1}={\:}_i^k{\mathbb{A}_u}_{1/2}^{1/2}$, 
     291where \eg\ in \autoref{eq:i13} $a_{1}={\:}_i^k{\mathbb{A}_u}_{1/2}^{1/2}$, 
    291292and in \autoref{eq:i31} $a'_{1}={\:}_i^k{\mathbb{A}_w}_{1/2}^{1/2}$. 
    292293 
     
    477478defined in terms of the distances between $T$, $u$,$f$ and $w$-points. 
    478479This is the natural discretization of \autoref{eq:cts-var}. 
    479 The \NEMO model, however, operates with scale factors instead of grid sizes, 
     480The \NEMO\ model, however, operates with scale factors instead of grid sizes, 
    480481and scale factors for the quarter cells are not defined. 
    481482Instead, therefore we simply choose 
     
    600601  It is a key property for a diffusion term. 
    601602  It means that it is also a dissipation term, 
    602   \ie it dissipates the square of the quantity on which it is applied. 
     603  \ie\ it dissipates the square of the quantity on which it is applied. 
    603604  It therefore ensures that, when the diffusivity coefficient is large enough, 
    604605  the field on which it is applied becomes free of grid-point noise. 
     
    649650Similar comments apply to triads that would intersect the ocean floor (\autoref{fig:bdry_triads}b). 
    650651Note that both near bottom triad slopes \triad{i}{k}{R}{1/2}{1/2} and \triad{i+1}{k}{R}{-1/2}{1/2} are masked when 
    651 either of the $i,k+1$ or $i+1,k+1$ tracer points is masked, \ie the $i,k+1$ $u$-point is masked. 
     652either of the $i,k+1$ or $i+1,k+1$ tracer points is masked, \ie\ the $i,k+1$ $u$-point is masked. 
    652653The associated lateral fluxes (grey-black dashed line) are masked if \np{ln\_botmix\_triad}\forcode{ = .false.}, 
    653654but left unmasked, giving bottom mixing, if \np{ln\_botmix\_triad}\forcode{ = .true.}. 
    654655 
    655656The default option \np{ln\_botmix\_triad}\forcode{ = .false.} is suitable when the bbl mixing option is enabled 
    656 (\key{trabbl}, with \np{nn\_bbl\_ldf}\forcode{ = 1}), or for simple idealized problems. 
     657(\np{ln\_trabbl}\forcode{ = .true.}, with \np{nn\_bbl\_ldf}\forcode{ = 1}), or for simple idealized problems. 
    657658For setups with topography without bbl mixing, \np{ln\_botmix\_triad}\forcode{ = .true.} may be necessary. 
    658659% >>>>>>>>>>>>>>>>>>>>>>>>>>>> 
     
    672673      (b) Both near bottom triad slopes \triad{i}{k}{R}{1/2}{1/2} and 
    673674      \triad{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, 
    674       \ie the $i,k+1$ $u$-point is masked. 
     675      \ie\ the $i,k+1$ $u$-point is masked. 
    675676      The associated lateral fluxes (grey-black dashed line) are masked if 
    676       \protect\np{botmix\_triad}\forcode{ = .false.}, but left unmasked, 
    677       giving bottom mixing, if \protect\np{botmix\_triad}\forcode{ = .true.} 
     677      \protect\np{ln\_botmix\_triad}\forcode{ = .false.}, but left unmasked, 
     678      giving bottom mixing, if \protect\np{ln\_botmix\_triad}\forcode{ = .true.} 
    678679    } 
    679680  \end{center} 
     
    687688iso-neutral slopes relative to geopotentials must be bounded everywhere, 
    688689both for consistency with the small-slope approximation and for numerical stability \citep{cox_OM87, griffies_bk04}. 
    689 The bound chosen in \NEMO is applied to each component of the slope separately and 
     690The bound chosen in \NEMO\ is applied to each component of the slope separately and 
    690691has a value of $1/100$ in the ocean interior. 
    691692%, ramping linearly down above 70~m depth to zero at the surface 
     
    765766  where $i,k_{10}$ is the tracer gridbox within which the depth reaches 10~m. 
    766767  See the left side of \autoref{fig:MLB_triad}. 
    767   We use the $k_{10}$-gridbox instead of the surface gridbox to avoid problems \eg with thin daytime mixed-layers. 
     768  We use the $k_{10}$-gridbox instead of the surface gridbox to avoid problems \eg\ with thin daytime mixed-layers. 
    768769  Currently we use the same $\Delta\rho_c=0.01\;\mathrm{kg\:m^{-3}}$ for ML triad tapering as is used to 
    769770  output the diagnosed mixed-layer depth $h_{\mathrm{ML}}=|z_{W}|_{k_{\mathrm{ML}}+1/2}$, 
     
    781782                                                       % \label{eq:Rbase} 
    782783    \\ 
    783     \intertext{with \eg the green triad} 
     784    \intertext{with \eg\ the green triad} 
    784785    {\:}_i{\mathbb{R}_{\mathrm{base}}}_{1/2}^{-1/2}&= 
    785786                                                     {\:}^{k_{\mathrm{ML}}}_i{\mathbb{R}_{\mathrm{base}}}_{\,1/2}^{-1/2}. 
     
    828829    ${\:}_i{\mathbb{R}_{\mathrm{base}}}_{\,i_p}^{k_p}$. 
    829830    Triads with different $i_p,k_p$, denoted by different colours, 
    830     (\eg the green triad $i_p=1/2,k_p=-1/2$) are tapered to the appropriate basal triad.} 
     831    (\eg\ the green triad $i_p=1/2,k_p=-1/2$) are tapered to the appropriate basal triad.} 
    831832  % } 
    832833  \includegraphics[width=\textwidth]{Fig_GRIFF_MLB_triads} 
     
    889890the formulation of which depends on the slopes of iso-neutral surfaces. 
    890891Contrary to the case of iso-neutral mixing, the slopes used here are referenced to the geopotential surfaces, 
    891 \ie \autoref{eq:ldfslp_geo} is used in $z$-coordinate, 
     892\ie\ \autoref{eq:ldfslp_geo} is used in $z$-coordinate, 
    892893and the sum \autoref{eq:ldfslp_geo} + \autoref{eq:ldfslp_iso} in $z^*$ or $s$-coordinates. 
    893894 
     
    918919The traditional way to implement this additional advection is to add it to the Eulerian velocity prior to 
    919920computing the tracer advection. 
    920 This is implemented if \key{traldf\_eiv} is set in the default implementation, 
     921This is implemented if \texttt{traldf\_eiv?} is set in the default implementation, 
    921922where \np{ln\_traldf\_triad} is set false. 
    922923This allows us to take advantage of all the advection schemes offered for the tracers 
     
    926927 
    927928However, when \np{ln\_traldf\_triad} is set true, 
    928 \NEMO instead implements eddy induced advection according to the so-called skew form \citep{griffies_JPO98}. 
     929\NEMO\ instead implements eddy induced advection according to the so-called skew form \citep{griffies_JPO98}. 
    929930It is based on a transformation of the advective fluxes using the non-divergent nature of the eddy induced velocity. 
    930931For example in the (\textbf{i},\textbf{k}) plane, 
     
    10341035\subsubsection{No change in tracer variance} 
    10351036 
    1036 The discretization conserves tracer variance, \ie it does not include a diffusive component but is a `pure' advection term. 
     1037The discretization conserves tracer variance, \ie\ it does not include a diffusive component but is a `pure' advection term. 
    10371038This can be seen %either from Appendix \autoref{apdx:eiv_skew} or 
    10381039by considering the fluxes associated with a given triad slope $_i^k{\mathbb{R}}_{i_p}^{k_p} (T)$. 
     
    11161117Thus surface layer triads $\triadt{i}{1}{R}{1/2}{-1/2}$ and $\triadt{i+1}{1}{R}{-1/2}{-1/2}$ are masked,  
    11171118and both near bottom triad slopes $\triadt{i}{k}{R}{1/2}{1/2}$ and $\triadt{i+1}{k}{R}{-1/2}{1/2}$ are masked when  
    1118 either of the $i,k+1$ or $i+1,k+1$ tracer points is masked, \ie the $i,k+1$ $u$-point is masked.  
     1119either of the $i,k+1$ or $i+1,k+1$ tracer points is masked, \ie\ the $i,k+1$ $u$-point is masked.  
    11191120The namelist parameter \np{ln\_botmix\_triad} has no effect on the eddy-induced skew-fluxes. 
    11201121 
Note: See TracChangeset for help on using the changeset viewer.