Thin-layer Boussinesq modules
These modules solve various thin-layer approximations to the hydrostatic Boussinesq equations. A thin-layer approximation is one that is appropriate for dynamics with small aspect ratios, or small vertical scales and large horizontal scales. Thin layer approximations include the shallow-water system, layered system, and spectral approximations that apply a Fourier or Sin/Cos eigenfunction expansion in the vertical coordinate to the Boussinesq equations, and truncate the expansion at just two or three modes. Approximations of this last flavor are described here.
The three-dimensional rotating, stratified, hydrostatic Boussinesq equations are
where $\bu = (u, \v, w)$ is the three-dimensional velocity, $b$ is buoyancy, $p$ is pressure, $N^2$ is the buoyancy frequency (constant), and $f$ is the rotation or Coriolis frequency. The operators $D^{\buu}$ and $D^{\bb}$ are arbitrary dissipation that we define only after projecting onto vertical Fourier or Sin/Cos modes. Taking the curl of the horizontal momentum equation yields an evolution equation for vertical vorticity, $\zzeta = \p_x \vv - \p_y \uu$:
Vertically Fourier Boussinesq
The vertically-Fourier Boussinesq module solves the Boussinesq system obtained by expanding the hydrostatic Boussinesq equations in a Fourier series. The horizontal velocity $\uu$, for example, is expanded with
The other variables $\vv$, $\bb$, $\pp$, $\zzeta$, and $\boomega$ are expanded identically. The barotropic horizontal velocity is $V$ and the barotropic vertical vorticity is $Z = \p_x V - \p_y U$. The barotropic vorticity obeys
where $\cc$ denotes the complex conjugate and contraction with $\pnabla = -\p_y \bxh + \p_x \byh$ gives the vertical component of the curl.
The baroclinic components obey
The dissipation operators are defined
where $U$ is the barotropic velocity and $u$ is the amplitude of the first baroclinic mode with periodic vertical structure $\mathrm{e}^{\mathrm{i} m z}$.
Implementation
Coming soon.
Vertically Cosine Boussinesq
The vertically-Cosine Boussinesq module solves the Boussinesq system obtained by expanding the hydrostatic Boussinesq equations in a Sin/Cos series. The horizontal velocity, for example, becomes
The horizontal velocity $\vv$, pressure $\pp$, and vertical vorticity $\zzeta$ are also expanded in $\cos(mz)$, where $Z = \p_x V - \p_y U$ denotes the barotropic component of the vertical vorticity. The vertical velocity $\ww$ and buoyancy $\bb$ are expanded with $\sin(mz)$.
Basic governing equations
Projecting the vertical vorticity equation onto Sin/Cos modes an equation for the evolution of $Z$,
where $\J(a, b) = (\p_x a)(\p_y b) - (\p_y a)(\p_x b)$ is the Jacobian operator, contraction with $\pnabla = -\p_y \bxh + \p_x \byh$ gives the vertical component of the curl, and $\Psi$ is the barotropic streamfunction defined so that
The baroclinic components obey
The dissipation operators are defined
where $2n_0$ and $2m_0$ are the hyperviscous orders of the arbitrary barotropic dissipation operators with coefficients $\nu_0$ and $\mu_0$, while $2n_1$ and $2m_1$ are the orders of the baroclinic dissipation operators.
A passive tracer in the Vertically Cosine Boussinesq system is assumed to satisfy a no-flux condition at the upper and lower boundaries, and thus expanded in cosine modes so that
The barotropic and baroclinic passive tracer components then obey
where $\kappa$ and $n_{\kappa}$ are the tracer hyperdiffusivity and order of the hyperdiffusivity, respectively. The choice $n_{\kappa} = 1$ corresponds to ordinary Fickian diffusivity.
Implementation
Coming soon.