environmentaltools.processes.calculate_wave_reflection

environmentaltools.processes.calculate_wave_reflection(T, mdat, t, xsn, h, dt)[source]

Calculate wave reflection parameters from multi-sensor measurements.

Analyzes time series from three aligned wave sensors to compute incident wave height, reflection coefficient, and phase difference using spectral separation methods.

Parameters:

  • T (float) – Wave energy period (s)

  • mdat (np.ndarray) – Surface elevation measurements (m), shape (ndat, 3) for three sensors

  • t (np.ndarray) – Time vector (s), currently unused but kept for compatibility

  • xsn (np.ndarray) – Sensor positions along wave propagation axis (m), length 3

  • h (float) – Water depth (m)

  • dt (float) – Sampling interval (s)

Returns:

  • HI (float) – Incident wave height (m)

  • R (float) – Reflection coefficient (dimensionless, 0-1)

  • fi (float) – Phase difference between incident and reflected waves (radians)

  • f (np.ndarray) – Frequency vector within analysis range (Hz)

  • Zi (np.ndarray) – Complex amplitudes of incident waves (m)

  • Zr (np.ndarray) – Complex amplitudes of reflected waves (m)

Notes

The reflection coefficient R is defined as: R = sqrt(Σ|Zr|² / Σ|Zi|²)

Incident wave height is computed from the zeroth moment of the incident spectrum: HI = sqrt(8 * m₀)

Uses Baquerizo’s least squares method for wave separation.