WVPseudoTopographicWaveGeneration

Generate internal waves from prescribed barotropic flow over topography.

---

Declaration

classdef WVPseudoTopographicWaveGeneration < WVForcing

Overview

WVPseudoTopographicWaveGeneration projects the first-order bottom velocity

\[g_b=\boldsymbol U_{\mathrm{bt}}(t)\boldsymbol{\cdot}\nabla_Hh\]

onto the rigid-lid wave modes using their bottom pressure. The projection is precomputed, so ordinary forcing calls add spectral wave tendencies without a pressure solve or spatial transform. By default, generation is projected outside the exact support of an active WVAdaptiveDamping. Optional horizontal-wavenumber and vertical-mode bounds support other closures. The incoming balanced tendency is left unchanged. Select a standard constituent with darwinSymbol, or supply a custom angular frequency.

forcing = WVPseudoTopographicWaveGeneration(wvt,topographicHeight=h,barotropicVelocityAmplitude=[0.05; 0],darwinSymbol="M2");
wvt.removeAllForcing();
wvt.addForcing(forcing);

Topics

• Create the forcing
  • WVPseudoTopographicWaveGeneration Create a prescribed bottom wave-generation forcing.
• Generate topography
  • goffAbyssalHillTopography Generate periodic Goff abyssal-hill topography.
• Inspect the forcing
  • barotropicVelocityAmplitude Complex barotropic velocity amplitude in meters per second.
  • darwinSymbol Darwin symbol used to select the tidal frequency.
  • frequency Barotropic angular frequency \(\omega\) in radians per second.
  • maximumForcedHorizontalWavenumber Largest radial horizontal wavenumber forced, in radians per meter.
  • maximumForcedVerticalMode Largest vertical wave-mode index forced.
  • rampDuration Duration of the half-cosine startup ramp in seconds.
  • shouldAvoidAdaptiveDamping Whether generation avoids active adaptive damping.
  • spectralGenerationMask Return the spectral region eligible for bottom-wave generation.
  • startTime Time at which the prescribed barotropic forcing begins, in seconds.
  • topographicHeight Upward-positive topographic height \(h(x,y)\) in meters.
• Evaluate the forcing
  • barotropicVelocityAtTime Evaluate the prescribed horizontally uniform current.
  • bottomVelocityAtTime Evaluate \(g_b=\boldsymbol U_{\mathrm{bt}}\boldsymbol{\cdot}\nabla_Hh\).
• Restart persistence
  • barotropicVelocityComponent Coordinate for the barotropic-velocity components.
  • classRequiredPropertyNames Return the forcing properties required for restart.

---