_ALE_timestep.dox

1/*! \page ALE_Timestep Vertical Lagrangian method in pictures
2
3\section section_ALE_remap Graphical explanation of vertical Lagrangian method
4
5Vertical Lagrangian regridding/remapping is not a timestep method in
6the traditional sense. Rather, it is a sequence of operations
7performed to bring the vertical grid back to a target specification
8(the regrid step), and then to remap the ocean state onto this new
9grid (the remap step). This regrid/remap process can be chosen to be
10less frequent than the momentum or thermodynamic timesteps. We are
11motivated to choose less frequent regrid/remap steps to save
12computational time and to reduce spurious mixing that occurs due to
13truncation errors in the remap step. However, there is a downside to
14delaying the regrid/remap. Namely, if delayed too long then the layer
15interfaces can become entangled (i.e., no longer monotonic in the
16vertical), which is a common problem with purely Lagrangian methods.
17On this page we illustrate the regrid/remap steps by making use of
18Figure 3 from Griffies, Adcroft, and Hallberg (2020)
19\cite Griffies_Adcroft_Hallberg2020.
20
21For purposes of this example, assume that the target vertical grid is
22comprised of geopotential \f$z\f$-surfaces, with the initial ocean
23state (e.g., the temperature field) shown on the left in the following
24figure.
25
26\image html remapping1.png "Initial state with level surface (left) and perturbed state after a wave has come through (right)" width=60%
27\image latex remapping1.png "Initial state with level surface (left) and perturbed state after a wave has come through (right)" width=0.6\textwidth
28
29Some time later, assume a wave has perturbed the ocean state. During
30the Lagrangian portion of the algorithm, the coordinate surfaces move
31vertically with the ocean fluid according to \f$\dot{r}=0\f$. Assume
32now that the algorithm has determined that a regrid step is needed,
33with the target vertical grid still geopotential \f$z\f$-surfaces, so
34this new target grid is shown overlaid on the left as a regrid.
35
36\image html remapping2.png "The regrid operation (left) and the remap operation (right)" width=60%
37\image latex remapping2.png "The regrid operation (left) and the remap operation (right)" width=0.6\textwidth
38
39The most complex part of the method involves remapping the wavy ocean
40field onto the new grid. This step also incurs truncation errors that
41are a function of the vertical grid spacing and the numerical method
42used to perform the remapping. We illustrate this remap step in the
43figure above, as well as in the frame below shown after the old
44deformed coordinate grid has been deleted:
45
46\image html remapping3.png "The final state after regriddinig and remapping" width=30%
47\image latex remapping3.png "The final state after regridding and remapping" width=0.3\textwidth
48
49The new layer thicknesses, \f$h_k\f$, are computed and then the layers
50are populated with the new velocities and tracers
51\f{align}
52 \sum h_k^{\scriptstyle{\mathrm{new}}} &= \sum h_k^{\scriptstyle{\mathrm{old}}}
53\\
54 \mathbf{u}_k^{\scriptstyle{\mathrm{new}}}
55 &= \frac{1}{h_k}
56 \int_{z_{k + 1/2}}^{z_{k + 1/2} + h_k} \mathbf{u}^{\scriptstyle{\mathrm{old}}}(z') \, \mathrm{d}z'
57\\
58 \theta_k^{\scriptstyle{\mathrm{new}}} &= \frac{1}{h_k}
59 \int_{z_{k + 1/2}}^{z_{k + 1/2} + h_k} \theta^{\scriptstyle{\mathrm{old}}}(z') \, \mathrm{d}z'
60\f}
61
62*/