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

Ignore:
Timestamp:
2018-12-21T15:18:38+01:00 (5 years ago)
Author:
nicolasmartin
Message:

Front page edition, cleaning in custom LaTeX commands and add index for single subfile compilation

  • Use \thanks storing cmd to refer to the ST members list for 2018 in an footnote on the cover page
  • NEMO and Fortran in small capitals
  • Removing of unused or underused custom cmds, move local cmds to their respective .tex file
  • Addition of new ones (\zstar, \ztilde, \sstar, \stilde, \ie, \eg, \fortran, \fninety)
  • Fonts for indexed items: italic font for files (modules and .nc files), preformat for code (CPP keys, routines names and namelists content)
File:
1 edited

Legend:

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

    r10414 r10442  
    6868\label{subsec:DYN_divcur} 
    6969 
    70 The vorticity is defined at an $f$-point ($i.e.$ corner point) as follows: 
     70The vorticity is defined at an $f$-point (\ie corner point) as follows: 
    7171\begin{equation} 
    7272  \label{eq:divcur_cur} 
     
    123123the tracer equation \autoref{eq:tra_nxt}: 
    124124a leapfrog scheme in combination with an Asselin time filter, 
    125 $i.e.$ the velocity appearing in \autoref{eq:dynspg_ssh} is centred in time (\textit{now} velocity). 
     125\ie the velocity appearing in \autoref{eq:dynspg_ssh} is centred in time (\textit{now} velocity). 
    126126This is of paramount importance. 
    127127Replacing $T$ by the number $1$ in the tracer equation and summing over the water column must lead to 
     
    149149The upper boundary condition applies at a fixed level $z=0$. 
    150150The top vertical velocity is thus equal to the divergence of the barotropic transport 
    151 ($i.e.$ the first term in the right-hand-side of \autoref{eq:dynspg_ssh}). 
     151(\ie the first term in the right-hand-side of \autoref{eq:dynspg_ssh}). 
    152152 
    153153Note also that whereas the vertical velocity has the same discrete expression in $z$- and $s$-coordinates, 
    154154its physical meaning is not the same: 
    155155in the second case, $w$ is the velocity normal to the $s$-surfaces. 
    156 Note also that the $k$-axis is re-orientated downwards in the \textsc{fortran} code compared to 
     156Note also that the $k$-axis is re-orientated downwards in the \fortran code compared to 
    157157the indexing used in the semi-discrete equations such as \autoref{eq:wzv} 
    158158(see \autoref{subsec:DOM_Num_Index_vertical}).  
     
    174174Options are defined through the \ngn{namdyn\_adv} namelist variables Coriolis and 
    175175momentum advection terms are evaluated using a leapfrog scheme, 
    176 $i.e.$ the velocity appearing in these expressions is centred in time (\textit{now} velocity).  
     176\ie the velocity appearing in these expressions is centred in time (\textit{now} velocity).  
    177177At the lateral boundaries either free slip, no slip or partial slip boundary conditions are applied following 
    178178\autoref{chap:LBC}. 
     
    208208In the enstrophy conserving case (ENS scheme), 
    209209the discrete formulation of the vorticity term provides a global conservation of the enstrophy 
    210 ($ [ (\zeta +f ) / e_{3f} ]^2 $ in $s$-coordinates) for a horizontally non-divergent flow ($i.e.$ $\chi$=$0$), 
     210($ [ (\zeta +f ) / e_{3f} ]^2 $ in $s$-coordinates) for a horizontally non-divergent flow (\ie $\chi$=$0$), 
    211211but does not conserve the total kinetic energy. 
    212212It is given by: 
     
    278278the presence of grid point oscillation structures that will be invisible to the operator. 
    279279These structures are \textit{computational modes} that will be at least partly damped by 
    280 the momentum diffusion operator ($i.e.$ the subgrid-scale advection), but not by the resolved advection term. 
     280the momentum diffusion operator (\ie the subgrid-scale advection), but not by the resolved advection term. 
    281281The ENS and ENE schemes therefore do not contribute to dump any grid point noise in the horizontal velocity field. 
    282282Such noise would result in more noise in the vertical velocity field, an undesirable feature. 
     
    327327(with a systematic reduction of $e_{3f}$ when a model level intercept the bathymetry) 
    328328that tends to reinforce the topostrophy of the flow 
    329 ($i.e.$ the tendency of the flow to follow the isobaths) \citep{Penduff_al_OS07}.  
     329(\ie the tendency of the flow to follow the isobaths) \citep{Penduff_al_OS07}.  
    330330 
    331331Next, the vorticity triads, $ {^i_j}\mathbb{Q}^{i_p}_{j_p}$ can be defined at a $T$-point as 
     
    354354This EEN scheme in fact combines the conservation properties of the ENS and ENE schemes. 
    355355It conserves both total energy and potential enstrophy in the limit of horizontally nondivergent flow 
    356 ($i.e.$ $\chi$=$0$) (see \autoref{subsec:C_vorEEN}).  
     356(\ie $\chi$=$0$) (see \autoref{subsec:C_vorEEN}).  
    357357Applied to a realistic ocean configuration, it has been shown that it leads to a significant reduction of 
    358358the noise in the vertical velocity field \citep{Le_Sommer_al_OM09}. 
     
    422422In the flux form (as in the vector invariant form), 
    423423the Coriolis and momentum advection terms are evaluated using a leapfrog scheme, 
    424 $i.e.$ the velocity appearing in their expressions is centred in time (\textit{now} velocity). 
     424\ie the velocity appearing in their expressions is centred in time (\textit{now} velocity). 
    425425At the lateral boundaries either free slip, 
    426426no slip or partial slip boundary conditions are applied following \autoref{chap:LBC}. 
     
    446446compute the product of the Coriolis parameter and the vorticity. 
    447447However, the energy-conserving scheme (\autoref{eq:dynvor_een}) has exclusively been used to date. 
    448 This term is evaluated using a leapfrog scheme, $i.e.$ the velocity is centred in time (\textit{now} velocity). 
     448This term is evaluated using a leapfrog scheme, \ie the velocity is centred in time (\textit{now} velocity). 
    449449 
    450450%-------------------------------------------------------------------------------------------------------------- 
     
    478478The schemes are selected using the namelist logicals \np{ln\_dynadv\_cen2} and \np{ln\_dynadv\_ubs}.  
    479479In flux form, the schemes differ by the choice of a space and time interpolation to define the value of 
    480 $u$ and $v$ at the centre of each face of $u$- and $v$-cells, $i.e.$ at the $T$-, $f$-, 
     480$u$ and $v$ at the centre of each face of $u$- and $v$-cells, \ie at the $T$-, $f$-, 
    481481and $uw$-points for $u$ and at the $f$-, $T$- and $vw$-points for $v$.  
    482482 
     
    498498\end{equation}  
    499499 
    500 The scheme is non diffusive (i.e. conserves the kinetic energy) but dispersive ($i.e.$ it may create false extrema). 
     500The scheme is non diffusive (\ie conserves the kinetic energy) but dispersive (\ie it may create false extrema). 
    501501It is therefore notoriously noisy and must be used in conjunction with an explicit diffusion operator to 
    502502produce a sensible solution. 
     
    522522\end{equation} 
    523523where $u"_{i+1/2} =\delta_{i+1/2} \left[ {\delta_i \left[ u \right]} \right]$. 
    524 This results in a dissipatively dominant ($i.e.$ hyper-diffusive) truncation error 
     524This results in a dissipatively dominant (\ie hyper-diffusive) truncation error 
    525525\citep{Shchepetkin_McWilliams_OM05}. 
    526526The overall performance of the advection scheme is similar to that reported in \citet{Farrow1995}. 
     
    529529But the amplitudes of the false extrema are significantly reduced over those in the centred second order method. 
    530530As the scheme already includes a diffusion component, it can be used without explicit lateral diffusion on momentum  
    531 ($i.e.$ \np{ln\_dynldf\_lap}\forcode{ = }\np{ln\_dynldf\_bilap}\forcode{ = .false.}), 
     531(\ie \np{ln\_dynldf\_lap}\forcode{ = }\np{ln\_dynldf\_bilap}\forcode{ = .false.}), 
    532532and it is recommended to do so. 
    533533 
    534534The UBS scheme is not used in all directions. 
    535 In the vertical, the centred $2^{nd}$ order evaluation of the advection is preferred, $i.e.$ $u_{uw}^{ubs}$ and 
     535In the vertical, the centred $2^{nd}$ order evaluation of the advection is preferred, \ie $u_{uw}^{ubs}$ and 
    536536$u_{vw}^{ubs}$ in \autoref{eq:dynadv_cen2} are used. 
    537537UBS is diffusive and is associated with vertical mixing of momentum. \gmcomment{ gm  pursue the  
     
    570570The key distinction between the different algorithms used for 
    571571the hydrostatic pressure gradient is the vertical coordinate used, 
    572 since HPG is a \emph{horizontal} pressure gradient, $i.e.$ computed along geopotential surfaces. 
     572since HPG is a \emph{horizontal} pressure gradient, \ie computed along geopotential surfaces. 
    573573As a result, any tilt of the surface of the computational levels will require a specific treatment to 
    574574compute the hydrostatic pressure gradient. 
    575575 
    576576The hydrostatic pressure gradient term is evaluated either using a leapfrog scheme, 
    577 $i.e.$ the density appearing in its expression is centred in time (\emph{now} $\rho$), 
     577\ie the density appearing in its expression is centred in time (\emph{now} $\rho$), 
    578578or a semi-implcit scheme. 
    579579At the lateral boundaries either free slip, no slip or partial slip boundary conditions are applied. 
     
    652652 
    653653Pressure gradient formulations in an $s$-coordinate have been the subject of a vast number of papers 
    654 ($e.g.$, \citet{Song1998, Shchepetkin_McWilliams_OM05}).  
     654(\eg, \citet{Song1998, Shchepetkin_McWilliams_OM05}).  
    655655A number of different pressure gradient options are coded but the ROMS-like, 
    656656density Jacobian with cubic polynomial method is currently disabled whilst known bugs are under investigation. 
     
    704704$\bullet$ The main hypothesis to compute the ice shelf load is that the ice shelf is in an isostatic equilibrium. 
    705705The top pressure is computed integrating from surface to the base of the ice shelf a reference density profile 
    706 (prescribed as density of a water at 34.4 PSU and -1.9\degC) and 
     706(prescribed as density of a water at 34.4 PSU and -1.9\deg{C}) and 
    707707corresponds to the water replaced by the ice shelf. 
    708708This top pressure is constant over time. 
     
    728728It involves the evaluation of the hydrostatic pressure gradient as 
    729729an average over the three time levels $t-\rdt$, $t$, and $t+\rdt$ 
    730 ($i.e.$  \textit{before}, \textit{now} and  \textit{after} time-steps), 
     730(\ie \textit{before}, \textit{now} and  \textit{after} time-steps), 
    731731rather than at the central time level $t$ only, as in the standard leapfrog scheme.  
    732732 
     
    820820the model time step is chosen to be small enough to resolve the external gravity waves 
    821821(typically a few tens of seconds). 
    822 The surface pressure gradient, evaluated using a leap-frog scheme ($i.e.$ centered in time), 
     822The surface pressure gradient, evaluated using a leap-frog scheme (\ie centered in time), 
    823823is thus simply given by : 
    824824\begin{equation} 
     
    832832\end{equation}  
    833833 
    834 Note that in the non-linear free surface case ($i.e.$ \key{vvl} defined), 
     834Note that in the non-linear free surface case (\ie \key{vvl} defined), 
    835835the surface pressure gradient is already included in the momentum tendency through 
    836836the level thickness variation allowed in the computation of the hydrostatic pressure gradient. 
     
    948948(\np{ln\_bt\_av}\forcode{ = .false.}).  
    949949In that case, external mode equations are continuous in time, 
    950 $i.e.$ they are not re-initialized when starting a new sub-stepping sequence. 
     950\ie they are not re-initialized when starting a new sub-stepping sequence. 
    951951This is the method used so far in the POM model, the stability being maintained by 
    952952refreshing at (almost) each barotropic time step advection and horizontal diffusion terms. 
     
    11241124the description of the coefficients is found in the chapter on lateral physics (\autoref{chap:LDF}). 
    11251125The lateral diffusion of momentum is evaluated using a forward scheme, 
    1126 $i.e.$ the velocity appearing in its expression is the \textit{before} velocity in time, 
     1126\ie the velocity appearing in its expression is the \textit{before} velocity in time, 
    11271127except for the pure vertical component that appears when a tensor of rotation is used. 
    11281128This latter term is solved implicitly together with the vertical diffusion term (see \autoref{chap:STP}). 
     
    11401140  In finite difference methods, 
    11411141  the biharmonic operator is frequently the method of choice to achieve this scale selective dissipation since 
    1142   its damping time ($i.e.$ its spin down time) scale like $\lambda^{-4}$ for disturbances of wavelength $\lambda$ 
     1142  its damping time (\ie its spin down time) scale like $\lambda^{-4}$ for disturbances of wavelength $\lambda$ 
    11431143  (so that short waves damped more rapidelly than long ones), 
    11441144  whereas the Laplace operator damping time scales only like $\lambda^{-2}$. 
     
    13151315 
    13161316(3) When \np{nn\_ice\_embd}\forcode{ = 2} and LIM or CICE is used 
    1317 ($i.e.$ when the sea-ice is embedded in the ocean), 
     1317(\ie when the sea-ice is embedded in the ocean), 
    13181318the snow-ice mass is taken into account when computing the surface pressure gradient. 
    13191319 
     
    13351335Options are defined through the \ngn{namdom} namelist variables. 
    13361336The general framework for dynamics time stepping is a leap-frog scheme, 
    1337 $i.e.$ a three level centred time scheme associated with an Asselin time filter (cf. \autoref{chap:STP}). 
     1337\ie a three level centred time scheme associated with an Asselin time filter (cf. \autoref{chap:STP}). 
    13381338The scheme is applied to the velocity, except when 
    13391339using the flux form of momentum advection (cf. \autoref{sec:DYN_adv_cor_flux}) 
     
    13791379\biblio 
    13801380 
     1381\pindex 
     1382 
    13811383\end{document} 
Note: See TracChangeset for help on using the changeset viewer.