Follow a sea state
toward the coast.
Bring the spectral description, transformation equations and conservation checks together in one bounded calculation. The aim is to explain every step from a prescribed offshore spectrum to a local result—not to imitate the capabilities of a full forecasting system.
The physical setting.
A straight coast lies north of an offshore boundary. Depth decreases linearly from 50 m to the selected local depth over 2 km; contours run east–west. The sea state is stationary and uniform along the contours. The calculation uses linear dispersion, Snell refraction and conservation of shoreward variance flux for each represented component.
The offshore spectrum contains a swell partition and a shorter-period partition with central toward bearings 320° and 50°. In the single-system case only the swell remains. Each partition uses a normalized Gaussian frequency shape and five weighted directional contributions. These are prescribed teaching spectra, not wind-generated predictions.
One optional loss experiment.
A prescribed attenuation coefficient μ reduces every component's shoreward flux by exp(−μy/2000), where y is the northward distance in metres. μ is a dimensionless cumulative attenuation over the whole transect. It is an accounting surrogate, not a bottom-friction or breaking formulation, and is applied per shoreward distance rather than distance along a ray.
With μ = 0, every component conserves flux. With μ > 0, the total boundary-to-local flux ratio must equal exp(−μ). This identity gives an independent check even when the spectral shape and height change. No wind input, nonlinear redistribution or breaking closure is included.
Run the idealized transect.
Hm0 at 21 stations along a 2 km straight transect. Station spacing is for displaying the analytic component transformation, not a finite-volume propagation grid.
Blue: offshore frequency marginal. Coral: local marginal from the same transformed directional contributions. Frequency bins are 0.005 Hz wide, centred from 0.05 to 0.25 Hz; all angular weights are integrated contributions.
Calculation recipe and checks
- Set target offshore variance m0 = (Hm0/4)². For two systems, allocate 65% to swell and 35% to the shorter-period partition; a single swell receives all the variance.
- Normalize the sampled Gaussian frequency weights on the stated finite grid. Swell standard deviation is 0.012 Hz; the shorter-period partition peaks at 0.16 Hz with standard deviation 0.018 Hz.
- Distribute each frequency-bin variance over direction offsets −10°, −5°, 0°, 5°, 10°, with normalized weights 1:4:6:4:1. No per-degree density is integrated as though it were per-radian density.
- At each station solve dispersion, turn each component using Snell's law and apply v = v0 Cg0 cosα0/[Cg cosα] × exp(−μy/2000).
- Sum local contributions to obtain m0, Hm0 and m1. Compute Tm01 = m0/m1 and the variance-weighted circular mean bearing. The mean bearing summarizes the mixture; it is not either partition's peak direction.
- Check the summed shoreward variance flux against the prescribed exponential ratio. Read the applicability notice before interpreting shallow-water results.
What this case can—and cannot—establish.
The calculation verifies an idealized stationary transformation and its flux account. It does not solve an arbitrary two-dimensional coastal domain, predict breaking or validate a real location. At large Hm0/depth, the nonbreaking extrapolation may be physically inappropriate even though the conservation equations still balance.
A site study would additionally need surveyed bathymetry, defensible boundary forcing, appropriate source formulations, spatial and spectral resolution tests, and independent observations. The exported station table records this example's inputs and outputs so its assumptions and results remain traceable.