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 2273 – NEMO

Changeset 2273


Ignore:
Timestamp:
2010-10-15T09:20:56+02:00 (14 years ago)
Author:
gm
Message:

ticket:#658 minor changes in STP and LBC

Location:
branches/DEV_r1826_DOC/DOC
Files:
3 edited

Legend:

Unmodified
Added
Removed
  • branches/DEV_r1826_DOC/DOC/NEMO_book.tex

    r2212 r2273  
    151151\newcommand{\key} [1] {\textbf{key\_#1}\index{CPP keys!key\_#1}}  %key_cpp (key) 
    152152\newcommand{\NEMO} {\textit{NEMO }}                %NEMO (nemo) 
    153 \newcommand{\amtcomment}[1]{#1}     % command to allow "commented out" portions of  
    154 \newcommand{\sgacomment}[1]{#1}     % command to allow "commented out" portions of  
    155 \newcommand{\gmcomment}[1]{}     % command to allow "commented out" portions of  
     153% command to "commented out" portions of text ({} argument) or not ({#1} argument) 
     154\newcommand{\amtcomment}[1]{}    % command to "commented out" portions of text or not (#1 in argument) 
     155\newcommand{\sgacomment}[1]{}    % command to "commented out" portions of  
     156\newcommand{\gmcomment}[1]{}     % command to "commented out" portions of  
    156157%                                               % text that span line breaks 
    157158\newcommand{\alpbet} {\left(\alpha / \beta \right)}   % alpha/beta  for slp computation 
  • branches/DEV_r1826_DOC/DOC/TexFiles/Chapters/Chap_LBC.tex

    r2213 r2273  
    738738\label{LBC_bdy} 
    739739 
    740 %-----------------------------------------nam_obc  ------------------------------------------- 
     740%-----------------------------------------nambdy-------------------------------------------- 
    741741%-    filbdy_mask    =  ''                  !  name of mask file (if ln_bdy_mask=.TRUE.) 
    742742%-    filbdy_data_T  = 'bdydata_grid_T.nc'  !  name of data file for FRS condition (T-points) 
     
    758758%-    volbdy         = 0                    !  = 0, the total water flux across open boundaries is zero 
    759759\namdisplay{nambdy}  
     760%----------------------------------------------------------------------------------------------- 
    760761 
    761762The BDY module is an alternative implementation of open boundary 
     
    768769 
    769770The BDY module was modelled on the OBC module and shares many features 
    770 and a similar coding structure \citet{Chanut2005}. 
     771and a similar coding structure \citep{Chanut2005}. 
    771772 
    772773%---------------------------------------------- 
     
    774775\label{BDY_FRS_scheme} 
    775776 
    776 The Flow Relaxation Scheme \citet{Davies_QJRMetSoc76},\citet{Engerdahl1995}, 
     777The Flow Relaxation Scheme (FRS) \citep{Davies_QJRMS76,Engerdahl_Tel95}, 
    777778applies a simple relaxation of the model fields to 
    778779externally-specified values over a zone next to the edge of the model 
     
    793794$\alpha$ and the model time step $\Delta t$: 
    794795\begin{equation}  \label{Eq_bdy_frs3} 
    795 \tau = \Delta t \frac{1-\alpha}{\alpha} 
     796\tau = \frac{1-\alpha}{\alpha}  \,\rdt 
    796797\end{equation} 
    797798Thus the model solution is completely prescribed by the external 
     
    803804The function $\alpha$ is specified as a $tanh$ function: 
    804805\begin{equation}  \label{Eq_bdy_frs4} 
    805 \alpha(d) = 1 - \tanh\left(\frac{1}{2}(d-1)\right)\;\;\;\;\; d=1,N 
     806\alpha(d) = 1 - \tanh\left(\frac{d-1}{2}\right),       \quad d=1,N 
    806807\end{equation} 
    807808The width of the FRS zone is specified in the namelist as  
    808 \np{nb\_rimwidth}. This is typically set to a value 
    809 between 8 and 10.  
     809\np{nb\_rimwidth}. This is typically set to a value between 8 and 10.  
    810810 
    811811%---------------------------------------------- 
     
    813813\label{BDY_flather_scheme} 
    814814 
    815 The Flather scheme \citet{Flather1994} is a radiation condition on the normal, depth-mean 
     815The \citet{Flather_JPO94} scheme is a radiation condition on the normal, depth-mean 
    816816transport across the open boundary. It takes the form 
    817817\begin{equation}  \label{Eq_bdy_fla1} 
     
    826826external depth-mean normal velocity, plus a correction term that 
    827827allows gravity waves generated internally to exit the model boundary. 
    828 Note that the sea-surface height gradient in Equation \ref{Eq_bdy_fla1} 
     828Note that the sea-surface height gradient in \eqref{Eq_bdy_fla1} 
    829829is a spatial gradient across the model boundary, so that $\eta_{e}$ is 
    830830defined on the $T$ points with $nbrdta=1$ and $\eta$ is defined on the 
    831831$T$ points with $nbrdta=2$. $U$ and $U_{e}$ are defined on the $U$ or 
    832 $V$ points with $nbrdta=1$, ie. between the two $T$ grid points. 
     832$V$ points with $nbrdta=1$, $i.e.$ between the two $T$ grid points. 
    833833 
    834834%---------------------------------------------- 
     
    837837 
    838838The Flow Relaxation Scheme may be applied separately to the 
    839 temperature and salinity (set \np{ln\_bdy\_tra\_frs} to .true.) and 
    840 the velocity fields (set \np{ln\_bdy\_dyn\_frs} to .true.). Flather 
     839temperature and salinity (\np{ln\_bdy\_tra\_frs} = true) and 
     840the velocity fields (\np{ln\_bdy\_dyn\_frs} = true). Flather 
    841841radiation conditions may be applied using externally defined 
    842 barotropic velocities and sea-surface height (set 
    843 \np{ln\_bdy\_dyn\_fla} to .true.) or using tidal harmonics fields (set 
    844 \np{ln\_bdy\_tides} to .true.) or both. FRS and Flather conditions may 
    845 be applied simultaneously. A typical configuration where all possible 
    846 conditions might be used is a tidal, shelf-seas model, where the barotropic 
    847 boundary conditions are fixed with the Flather scheme using tidal 
    848 harmonics and possibly output from a large-scale model, and FRS 
    849 conditions are applied to the tracers and baroclinic velocity fields, 
    850 using fields from a large-scale model. 
     842barotropic velocities and sea-surface height (\np{ln\_bdy\_dyn\_fla} = true)  
     843or using tidal harmonics fields (\np{ln\_bdy\_tides} = true)  
     844or both. FRS and Flather conditions may be applied simultaneously.  
     845A typical configuration where all possible conditions might be used is a tidal,  
     846shelf-seas model, where the barotropic boundary conditions are fixed  
     847with the Flather scheme using tidal harmonics and possibly output  
     848from a large-scale model, and FRS conditions are applied to the tracers  
     849and baroclinic velocity fields, using fields from a large-scale model. 
    851850 
    852851Note that FRS conditions will work with the filtered 
     
    903902also have a depth dimension. 
    904903 
    905 If \np{ln\_bdy\_clim} is set to $.false.$, the model expects the 
     904If \np{ln\_bdy\_clim} is set to $false$, the model expects the 
    906905units of the time axis to have the form shown in 
    907 \ref{Fig_bdy_input_file}, ie. {\it ``seconds since yyyy-mm-dd 
     906\ref{Fig_bdy_input_file}, $i.e.$ {\it ``seconds since yyyy-mm-dd 
    908907hh:mm:ss''} The fields are then linearly interpolated to the model 
    909908time at each timestep. Note that for this option, the time axis of the 
     
    940939\label{BDY_tides} 
    941940 
    942  
    943  
    944  
    945  
     941To be written.... 
     942 
     943 
     944 
     945 
  • branches/DEV_r1826_DOC/DOC/TexFiles/Chapters/Chap_STP.tex

    r2211 r2273  
    137137constraint on the time step. Two solutions are available in \NEMO to overcome  
    138138the stability constraint: $(a)$ a forward time differencing scheme using a  
    139 time splitting technique (\np{ln\_zdfexp}=.true.) or $(b)$ a backward (or implicit)  
    140 time differencing scheme (\np{ln\_zdfexp}=.false.). In $(a)$, the master  
     139time splitting technique (\np{ln\_zdfexp} = true) or $(b)$ a backward (or implicit)  
     140time differencing scheme (\np{ln\_zdfexp} = false). In $(a)$, the master  
    141141time step $\Delta $t is cut into $N$ fractional time steps so that the  
    142142stability criterion is reduced by a factor of $N$. The computation is performed as  
     
    168168\end{equation} 
    169169where RHS is the right hand side of the equation except for the vertical diffusion term.  
    170 \sgacomment{why change from T to u in the following equation?} 
    171170We rewrite \eqref{Eq_STP_imp} as: 
    172171\begin{equation} \label{Eq_STP_imp_mat} 
    173 -c(k+1)\;u^{t+1}(k+1) + d(k)\;u^{t+1}(k) - \;c(k)\;u^{t+1}(k-1) \equiv b(k) 
     172-c(k+1)\;T^{t+1}(k+1) + d(k)\;T^{t+1}(k) - \;c(k)\;T^{t+1}(k-1) \equiv b(k) 
    174173\end{equation} 
    175174where  
    176175\begin{align*}  
    177  c(k) &= A_w^{vm} (k) \, / \, e_{3uw} (k)     \\ 
    178  d(k) &= e_{3u} (k)       \, / \, (2\rdt) + c_k + c_{k+1}    \\ 
    179  b(k) &= e_{3u} (k) \; \left( u^{t-1}(k) \, / \, (2\rdt) + \text{RHS} \right)     
     176 c(k) &= A_w^{vT} (k) \, / \, e_{3w} (k)     \\ 
     177 d(k) &= e_{3t} (k)       \, / \, (2\rdt) + c_k + c_{k+1}    \\ 
     178 b(k) &= e_{3t} (k) \; \left( T^{t-1}(k) \, / \, (2\rdt) + \text{RHS} \right)     
    180179\end{align*} 
    181180 
     
    226225as the Forward-Backward scheme used in MOM \citep{Griffies_al_OS05} and more  
    227226efficient than the LF-AM3 scheme (leapfrog time stepping combined with a third order 
    228 Adams-Moulton interpolation for the predictor phase) used in ROMS  
     227Adams-Moulthon interpolation for the predictor phase) used in ROMS  
    229228\citep{Shchepetkin_McWilliams_OM05}.  
    230229 
     
    234233frequency IGWs. Obviously, the doubling of the time-step is achievable only  
    235234if no other factors control the time-step, such as the stability limits associated  
    236 with advection, diffusion or Coriolis terms. For example, it is useless in low resolution 
     235with advection, diffusion or Coriolis terms. For example, it is inefficient in low resolution 
    237236global ocean configurations, since inertial oscillations in the vicinity of the North Pole  
    238 are the limiting factor for the time step. It is also often useless in very high  
     237are the limiting factor for the time step. It is also often inefficient in very high  
    239238resolution configurations where strong currents and small grid cells exert  
    240239the strongest constraint on the time step. 
    241 \sgacomment{ not sure "useless" is the right word here. "valueless", "inefficient"?} 
    242  
    243240 
    244241% ------------------------------------------------------------------------------------------------------------- 
     
    255252In a classical LF-RA environment, the forcing term is centred in time, $i.e.$  
    256253it is time-stepped over a $2\rdt$ period:  $x^t  = x^t + 2\rdt Q^t $ where $Q$  
    257 is the filtered forcing applied to $x$, and the filter is given by \eqref{Eq_STP_asselin}.  
     254is the forcing applied to $x$, and the time filter is given by \eqref{Eq_STP_asselin}  
     255so that $Q$ is redistributed over several time step.  
    258256In the modified LF-RA environment, these two formulations have been replaced by: 
    259257\begin{align}  
     
    263261           - \gamma\,\rdt \, \left[ Q^{t+\rdt/2} -  Q^{t-\rdt/2} \right]                          \label{Eq_STP_RA} 
    264262\end{align} 
    265 \sgacomment{Q(t)=f(x(t-dt),x(t),x(t+dt)), Q(t-dt/2)?} 
    266  
    267263The change in the forcing formulation given by \eqref{Eq_STP_forcing}  
    268264(see Fig.\ref{Fig_MLF_forcing}) has a significant effect: the forcing term no  
    269265longer excites the divergence of odd and even time steps \citep{Leclair_Madec_OM09}.  
     266% forcing seen by the model.... 
    270267This property improves the LF-RA scheme in two respects.  
    271 First, the LF-RA becomes a truly quasi-second order scheme. Indeed,  
     268First, the LF-RA can now ensure the local and global conservation of tracers. 
     269Indeed, time filtering is no longer required on the forcing part. The influence of  
     270the Asselin filter on the forcing is be removed by adding a new term in the filter 
     271(last term in \eqref{Eq_STP_RA} compared to \eqref{Eq_STP_asselin}). Since  
     272the filtering of the forcing was the source of non-conservation in the classical  
     273LF-RA scheme, the modified formulation becomes conservative  \citep{Leclair_Madec_OM09}. 
     274Second, the LF-RA becomes a truly quasi-second order scheme. Indeed,  
    272275\eqref{Eq_STP_forcing} used in combination with a careful treatment of static  
    273276instability (\S\ref{ZDF_evd}) and of the TKE physics (\S\ref{ZDF_tke_ene}), 
    274 the two other main sources of time step divergence, allows a reduction by two orders  
    275 of magnitude of the Asselin filter parameter.  
    276 Second, the LF-RA can now ensure the local and global conservation of tracers. 
    277 Indeed, time filtering is no longer required on the forcing part.  
    278 \sgacomment{ but Q is described above as the forcing part!} The influence of  
    279 the forcing in the Asselin filter can be removed by adding a new term in the filter 
    280 (last term in \eqref{Eq_STP_RA} compared to \eqref{Eq_STP_asselin}). Since  
    281 the filtering of the forcing was the source of non-conservation in the LF-RA 
    282 scheme, it becomes conservative  \citep{Leclair_Madec_OM09}. 
     277the two other main sources of time step divergence, allows a reduction by  
     278two orders of magnitude of the Asselin filter parameter.  
    283279 
    284280Note that the forcing is now provided at the middle of a time step: $Q^{t+\rdt/2}$  
     
    292288\begin{figure}[!t] \label{Fig_MLF_forcing}  \begin{center} 
    293289\includegraphics[width=0.90\textwidth]{./TexFiles/Figures/Fig_MLF_forcing.pdf} 
    294 \caption{Illustration of forcing integration methods. ''Traditional'' formulation (top)  
    295 where a centred forcing is applied over a $2\rdt$ period and modified formulation  
    296 (bottom) where a mean forcing over the two successive time step is applied over a $2\rdt$ period.} 
     290\caption{Illustration of forcing integration methods.  
     291(top) ''Traditional'' formulation : the forcing is defined at the same time as the variable  
     292on which it is applied (integer value of the time step index) and it is applied over a $2\rdt$ period.  
     293(bottom)  modified formulation : the forcing is defined in the mid of the time (integer and a half  
     294value of the time step index) and the mean of two successive forcing ($n-1/2$, $n+1/2$). 
     295is applied over a $2\rdt$ period.} 
    297296\end{center}   \end{figure} 
    298297%>>>>>>>>>>>>>>>>>>>>>>>>>>>> 
    299298 
    300 \sgacomment{two methods in caption sound the same} 
     299\sgacomment{two methods in caption sound the same ==> gm:  I try to change this, but I'm not happy with the result} 
    301300 
    302301% ------------------------------------------------------------------------------------------------------------- 
     
    314313   x^1 = x^0 + \rdt \ \text{RHS}^0 
    315314\end{equation} 
    316 This is done simply by keeping the leapfrog environment but setting all $x^0$ (\textit{before}) 
    317 and $x^{1/2}$ (\textit{now}) fields equal at the first time step. 
     315This is done simply by keeping the leapfrog environment ($i.e.$ the \eqref{Eq_STP}  
     316three level time stepping) but setting all $x^0$ (\textit{before}) and $x^{1}$ (\textit{now}) fields  
     317equal at the first time step and using half the value of $\rdt$. 
    318318 
    319319It is also possible to restart from a previous computation, by using a  
     
    328328gradient (see \S\ref{DYN_hpg_imp}), an extra three-dimensional field has to be  
    329329added to the restart file to ensure an exact restartability. This is done optionally  
    330 via the namelist parameter \np{nn\_dynhpg\_rst}, so that the size of the 
     330via the  \np{nn\_dynhpg\_rst} namelist parameter, so that the size of the 
    331331restart file can be reduced when restartability is not a key issue (operational  
    332332oceanography or in ensemble simulations for seasonal forecasting). 
Note: See TracChangeset for help on using the changeset viewer.