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_model_basics_zstar.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_model_basics_zstar.tex

    r9393 r9407  
    2727To overcome problems with vanishing surface and/or bottom cells, we consider the  
    2828zstar coordinate  
    29 \begin{equation} \label{PE_} 
     29\begin{equation} \label{eq:PE_} 
    3030   z^\star = H \left( \frac{z-\eta}{H+\eta} \right) 
    3131\end{equation} 
     
    3939The surfaces of constant $z^\star$ are quasi-horizontal. Indeed, the $z^\star$ coordinate reduces to $z$ when $\eta$ is zero. In general, when noting the large differences between  
    4040undulations of the bottom topography versus undulations in the surface height, it  
    41 is clear that surfaces constant $z^\star$ are very similar to the depth surfaces. These properties greatly reduce difficulties of computing the horizontal pressure gradient relative to terrain following sigma models discussed in \S\ref{PE_sco}.  
     41is clear that surfaces constant $z^\star$ are very similar to the depth surfaces. These properties greatly reduce difficulties of computing the horizontal pressure gradient relative to terrain following sigma models discussed in \autoref{subsec:PE_sco}.  
    4242Additionally, since $z^\star$ when $\eta = 0$, no flow is spontaneously generated in an  
    4343unforced ocean starting from rest, regardless the bottom topography. This behaviour is in contrast to the case with "s"-models, where pressure gradient errors in  
     
    4545gradient solver. The quasi-horizontal nature of the coordinate surfaces also facilitates the implementation of neutral physics parameterizations in $z^\star$ models using  
    4646the same techniques as in $z$-models (see Chapters 13-16 of Griffies (2004) for a  
    47 discussion of neutral physics in $z$-models, as well as Section \S\ref{LDF_slp}  
     47discussion of neutral physics in $z$-models, as well as  \autoref{sec:LDF_slp}  
    4848in this document for treatment in \NEMO).  
    4949 
     
    7676% ================================================================ 
    7777\section{Surface pressure gradient and sea surface heigth (\protect\mdl{dynspg})} 
    78 \label{DYN_hpg_spg} 
     78\label{sec:DYN_hpg_spg} 
    7979%-----------------------------------------nam_dynspg---------------------------------------------------- 
    8080\forfile{../namelists/nam_dynspg}  
    8181%------------------------------------------------------------------------------------------------------------ 
    8282Options are defined through the  \ngn{nam\_dynspg} namelist variables. 
    83 The surface pressure gradient term is related to the representation of the free surface (\S\ref{PE_hor_pg}). The main distinction is between the fixed volume case (linear free surface or rigid lid) and the variable volume case (nonlinear free surface, \key{vvl} is active). In the linear free surface case (\S\ref{PE_free_surface}) and rigid lid (\S\ref{PE_rigid_lid}), the vertical scale factors $e_{3}$ are fixed in time, while in the nonlinear case (\S\ref{PE_free_surface}) they are time-dependent. With both linear and nonlinear free surface, external gravity waves are allowed in the equations, which imposes a very small time step when an explicit time stepping is used. Two methods are proposed to allow a longer time step for the three-dimensional equations: the filtered free surface, which is a modification of the continuous equations (see \eqref{Eq_PE_flt}), and the split-explicit free surface described below. The extra term introduced in the filtered method is calculated implicitly, so that the update of the next velocities is done in module \mdl{dynspg\_flt} and not in \mdl{dynnxt}. 
     83The surface pressure gradient term is related to the representation of the free surface (\autoref{sec:PE_hor_pg}). The main distinction is between the fixed volume case (linear free surface or rigid lid) and the variable volume case (nonlinear free surface, \key{vvl} is active). In the linear free surface case (\autoref{subsec:PE_free_surface}) and rigid lid (\autoref{PE_rigid_lid}), the vertical scale factors $e_{3}$ are fixed in time, while in the nonlinear case (\autoref{subsec:PE_free_surface}) they are time-dependent. With both linear and nonlinear free surface, external gravity waves are allowed in the equations, which imposes a very small time step when an explicit time stepping is used. Two methods are proposed to allow a longer time step for the three-dimensional equations: the filtered free surface, which is a modification of the continuous equations (see \autoref{eq:PE_flt}), and the split-explicit free surface described below. The extra term introduced in the filtered method is calculated implicitly, so that the update of the next velocities is done in module \mdl{dynspg\_flt} and not in \mdl{dynnxt}. 
    8484 
    8585%------------------------------------------------------------- 
     
    8787%------------------------------------------------------------- 
    8888\subsubsection{Explicit (\protect\key{dynspg\_exp})} 
    89 \label{DYN_spg_exp} 
     89\label{subsec:DYN_spg_exp} 
    9090 
    9191In the explicit free surface formulation, the model time step is chosen small enough to describe the external gravity waves (typically a few ten seconds). The sea surface height is given by : 
    92 \begin{equation} \label{Eq_dynspg_ssh} 
     92\begin{equation} \label{eq:dynspg_ssh} 
    9393\frac{\partial \eta }{\partial t}\equiv \frac{\text{EMP}}{\rho _w }+\frac{1}{e_{1T}  
    9494e_{2T} }\sum\limits_k {\left( {\delta _i \left[ {e_{2u} e_{3u} u}  
     
    9696\end{equation} 
    9797 
    98 where EMP is the surface freshwater budget (evaporation minus precipitation, and minus river runoffs (if the later are introduced as a surface freshwater flux, see \S\ref{SBC}) expressed in $Kg.m^{-2}.s^{-1}$, and $\rho _w =1,000\,Kg.m^{-3}$ is the volumic mass of pure water. The sea-surface height is evaluated using a leapfrog scheme in combination with an Asselin time filter, i.e. the velocity appearing in (\ref{Eq_dynspg_ssh}) is centred in time (\textit{now} velocity).  
     98where EMP is the surface freshwater budget (evaporation minus precipitation, and minus river runoffs (if the later are introduced as a surface freshwater flux, see \autoref{chap:SBC}) expressed in $Kg.m^{-2}.s^{-1}$, and $\rho _w =1,000\,Kg.m^{-3}$ is the volumic mass of pure water. The sea-surface height is evaluated using a leapfrog scheme in combination with an Asselin time filter, i.e. the velocity appearing in (\autoref{eq:dynspg_ssh}) is centred in time (\textit{now} velocity).  
    9999 
    100100The surface pressure gradient, also evaluated using a leap-frog scheme, is then simply given by : 
    101 \begin{equation} \label{Eq_dynspg_exp} 
     101\begin{equation} \label{eq:dynspg_exp} 
    102102\left\{ \begin{aligned} 
    103103 - \frac{1}                      {e_{1u}} \; \delta _{i+1/2} \left[  \,\eta\,  \right]    \\ 
     
    107107\end{equation}  
    108108 
    109 Consistent with the linearization, a $\left. \rho \right|_{k=1} / \rho _o$ factor is omitted in (\ref{Eq_dynspg_exp}).  
     109Consistent with the linearization, a $\left. \rho \right|_{k=1} / \rho _o$ factor is omitted in (\autoref{eq:dynspg_exp}).  
    110110 
    111111%------------------------------------------------------------- 
     
    113113%------------------------------------------------------------- 
    114114\subsubsection{Split-explicit time-stepping (\protect\key{dynspg\_ts})} 
    115 \label{DYN_spg_ts} 
     115\label{subsec:DYN_spg_ts} 
    116116%--------------------------------------------namdom---------------------------------------------------- 
    117117\forfile{../namelists/namdom}  
     
    124124\begin{figure}[!t]   \begin{center} 
    125125\includegraphics[width=0.90\textwidth]{Fig_DYN_dynspg_ts} 
    126 \caption{    \protect\label{Fig_DYN_dynspg_ts} 
     126\caption{    \protect\label{fig:DYN_dynspg_ts} 
    127127Schematic of the split-explicit time stepping scheme for the barotropic and baroclinic modes,  
    128128after \citet{Griffies2004}. Time increases to the right. Baroclinic time steps are denoted by  
     
    151151scheme using the small barotropic time step $\Delta t$. We have  
    152152 
    153 \begin{equation} \label{DYN_spg_ts_eta} 
     153\begin{equation} \label{eq:DYN_spg_ts_eta} 
    154154\eta^{(b)}(\tau,t_{n+1}) - \eta^{(b)}(\tau,t_{n+1}) (\tau,t_{n-1}) 
    155155   = 2 \Delta t \left[-\nabla \cdot \textbf{U}^{(b)}(\tau,t_n) + \text{EMP}_w(\tau) \right]  
    156156\end{equation} 
    157 \begin{multline} \label{DYN_spg_ts_u} 
     157\begin{multline} \label{eq:DYN_spg_ts_u} 
    158158\textbf{U}^{(b)}(\tau,t_{n+1}) - \textbf{U}^{(b)}(\tau,t_{n-1})  \\ 
    159159   = 2\Delta t \left[ - f \textbf{k} \times \textbf{U}^{(b)}(\tau,t_{n})  
     
    165165and $U^{(b)}$ denotes the baroclinic time at which the vertically integrated forcing $\textbf{M}(\tau)$ (note that this forcing includes the surface freshwater forcing), the tracer fields, the freshwater flux $\text{EMP}_w(\tau)$, and total depth of the ocean $H(\tau)$ are held for the duration of the barotropic time stepping over a single cycle. This is also the time  
    166166that sets the barotropic time steps via  
    167 \begin{equation} \label{DYN_spg_ts_t} 
     167\begin{equation} \label{eq:DYN_spg_ts_t} 
    168168t_n=\tau+n\Delta t    
    169169\end{equation} 
    170170with $n$ an integer. The density scaled surface pressure is evaluated via  
    171 \begin{equation} \label{DYN_spg_ts_ps} 
     171\begin{equation} \label{eq:DYN_spg_ts_ps} 
    172172p_s^{(b)}(\tau,t_{n}) = \begin{cases} 
    173173   g \;\eta_s^{(b)}(\tau,t_{n}) \;\rho(\tau)_{k=1}) / \rho_o  &      \text{non-linear case} \\ 
     
    176176\end{equation} 
    177177To get started, we assume the following initial conditions  
    178 \begin{equation} \label{DYN_spg_ts_eta} 
     178\begin{equation} \label{eq:DYN_spg_ts_eta} 
    179179\begin{split} 
    180180\eta^{(b)}(\tau,t_{n=0}) &= \overline{\eta^{(b)}(\tau)} 
     
    184184\end{equation} 
    185185with  
    186 \begin{equation} \label{DYN_spg_ts_etaF} 
     186\begin{equation} \label{eq:DYN_spg_ts_etaF} 
    187187 \overline{\eta^{(b)}(\tau)} = \frac{1}{N+1} \sum\limits_{n=0}^N \eta^{(b)}(\tau-\Delta t,t_{n}) 
    188188\end{equation} 
    189189the time averaged surface height taken from the previous barotropic cycle. Likewise,  
    190 \begin{equation} \label{DYN_spg_ts_u} 
     190\begin{equation} \label{eq:DYN_spg_ts_u} 
    191191\textbf{U}^{(b)}(\tau,t_{n=0}) = \overline{\textbf{U}^{(b)}(\tau)}   \\ 
    192192\\ 
     
    194194\end{equation} 
    195195with  
    196 \begin{equation} \label{DYN_spg_ts_u} 
     196\begin{equation} \label{eq:DYN_spg_ts_u} 
    197197 \overline{\textbf{U}^{(b)}(\tau)}  
    198198   = \frac{1}{N+1} \sum\limits_{n=0}^N\textbf{U}^{(b)}(\tau-\Delta t,t_{n}) 
     
    201201 
    202202Upon reaching $t_{n=N} = \tau + 2\Delta \tau$ , the vertically integrated velocity is time averaged to produce the updated vertically integrated velocity at baroclinic time $\tau + \Delta \tau$  
    203 \begin{equation} \label{DYN_spg_ts_u} 
     203\begin{equation} \label{eq:DYN_spg_ts_u} 
    204204\textbf{U}(\tau+\Delta t) = \overline{\textbf{U}^{(b)}(\tau+\Delta t)}  
    205205   = \frac{1}{N+1} \sum\limits_{n=0}^N\textbf{U}^{(b)}(\tau,t_{n}) 
     
    207207The surface height on the new baroclinic time step is then determined via a baroclinic leap-frog using the following form  
    208208 
    209 \begin{equation} \label{DYN_spg_ts_ssh} 
     209\begin{equation} \label{eq:DYN_spg_ts_ssh} 
    210210\eta(\tau+\Delta) - \eta^{F}(\tau-\Delta) = 2\Delta t \ \left[ - \nabla \cdot \textbf{U}(\tau) + \text{EMP}_w \right]   
    211211\end{equation} 
     
    214214  
    215215In general, some form of time filter is needed to maintain integrity of the surface  
    216 height field due to the leap-frog splitting mode in equation \ref{DYN_spg_ts_ssh}. We  
     216height field due to the leap-frog splitting mode in equation \autoref{eq:DYN_spg_ts_ssh}. We  
    217217have tried various forms of such filtering, with the following method discussed in  
    218218Griffies et al. (2001) chosen due to its stability and reasonably good maintenance of  
    219 tracer conservation properties (see Section ??)  
    220  
    221 \begin{equation} \label{DYN_spg_ts_sshf} 
     219tracer conservation properties (see ??)  
     220 
     221\begin{equation} \label{eq:DYN_spg_ts_sshf} 
    222222\eta^{F}(\tau-\Delta) =  \overline{\eta^{(b)}(\tau)}  
    223223\end{equation} 
    224224Another approach tried was  
    225225 
    226 \begin{equation} \label{DYN_spg_ts_sshf2} 
     226\begin{equation} \label{eq:DYN_spg_ts_sshf2} 
    227227\eta^{F}(\tau-\Delta) = \eta(\tau)  
    228228   + (\alpha/2) \left[\overline{\eta^{(b)}}(\tau+\Delta t) 
     
    232232which is useful since it isolates all the time filtering aspects into the term multiplied  
    233233by $\alpha$. This isolation allows for an easy check that tracer conservation is exact when  
    234 eliminating tracer and surface height time filtering (see Section ?? for more complete discussion). However, in the general case with a non-zero $\alpha$, the filter \ref{DYN_spg_ts_sshf} was found to be more conservative, and so is recommended.  
     234eliminating tracer and surface height time filtering (see ?? for more complete discussion). However, in the general case with a non-zero $\alpha$, the filter \autoref{eq:DYN_spg_ts_sshf} was found to be more conservative, and so is recommended.  
    235235 
    236236 
     
    242242%------------------------------------------------------------- 
    243243\subsubsection{Filtered formulation (\protect\key{dynspg\_flt})} 
    244 \label{DYN_spg_flt} 
     244\label{subsec:DYN_spg_flt} 
    245245 
    246246The filtered formulation follows the \citet{Roullet2000} implementation. The extra term introduced in the equations (see {\S}I.2.2) is solved implicitly. The elliptic solvers available in the code are  
    247 documented in \S\ref{MISC}. The amplitude of the extra term is given by the namelist variable \np{rnu}. The default value is 1, as recommended by \citet{Roullet2000} 
     247documented in \autoref{chap:MISC}. The amplitude of the extra term is given by the namelist variable \np{rnu}. The default value is 1, as recommended by \citet{Roullet2000} 
    248248 
    249249\colorbox{red}{\np{rnu}\forcode{ = 1} to be suppressed from namelist !} 
     
    253253%------------------------------------------------------------- 
    254254\subsection{Non-linear free surface formulation (\protect\key{vvl})} 
    255 \label{DYN_spg_vvl} 
    256  
    257 In the non-linear free surface formulation, the variations of volume are fully taken into account. This option is presented in a report \citep{Levier2007} available on the NEMO web site. The three time-stepping methods (explicit, split-explicit and filtered) are the same as in \S\ref{DYN_spg_linear} except that the ocean depth is now time-dependent. In particular, this means that in filtered case, the matrix to be inverted has to be recomputed at each time-step. 
     255\label{subsec:DYN_spg_vvl} 
     256 
     257In the non-linear free surface formulation, the variations of volume are fully taken into account. This option is presented in a report \citep{Levier2007} available on the NEMO web site. The three time-stepping methods (explicit, split-explicit and filtered) are the same as in \autoref{DYN_spg_linear} except that the ocean depth is now time-dependent. In particular, this means that in filtered case, the matrix to be inverted has to be recomputed at each time-step. 
    258258 
    259259 
Note: See TracChangeset for help on using the changeset viewer.