seasonder_getBraggLineBins: Get Bragg Line Doppler Bins

In SeaSondeR: Radial Metrics from SeaSonde HF-Radar Data

Get Bragg Line Doppler Bins

Description

This function calculates the Doppler bin indices corresponding to the first-order Bragg frequencies (-1 and 1) for a SeaSonde Cross Spectra (CS) object.

Usage

seasonder_getBraggLineBins(seasonder_cs_object)

Arguments

seasonder_cs_object

A SeaSonde Cross Spectra (CS) object created by seasonder_createSeaSondeRCS(). This object contains the metadata required for the computation, including the normalized Doppler frequencies and their mapping to Doppler bins.

Details

This function uses the normalized Doppler frequencies for the first-order Bragg peaks (-1 and 1) and maps them to their corresponding Doppler bin indices. The mapping is performed using the helper function seasonder_NormalizedDopplerFreq2Bins(), which converts normalized frequencies to bin indices based on the spectral resolution and the Doppler range of the radar system.

The bins are critical for identifying the Doppler shifts associated with the first-order Bragg scattering in HF radar systems, which correspond to surface waves with wavelengths half that of the transmitted radar signal.

Value

A numeric vector of length 2, where:

• The first value is the Doppler bin corresponding to the -1 Bragg frequency.

• The second value is the Doppler bin corresponding to the 1 Bragg frequency.

See Also

seasonder_NormalizedDopplerFreq2Bins for the frequency-to-bin mapping logic.

SeaSondeR documentation built on June 8, 2025, 10:50 a.m.