seasonder_rejectDistantBragg: Apply Distant Bragg Peak Rejection to All Range Cells

In SeaSondeR: Radial Metrics from SeaSonde HF-Radar Data

Apply Distant Bragg Peak Rejection to All Range Cells

Description

This function applies a proximity-based rejection test to all detected First Order Region (FOR) peaks in a SeaSondeRCS object. Peaks that are too far from their corresponding Bragg indices are removed, ensuring that only valid Bragg signals are retained.

Usage

seasonder_rejectDistantBragg(seasonder_cs_object)

Arguments

seasonder_cs_object

A SeaSondeRCS object containing the spectral data and FOR parameters.

Details

Reason for the Test: The function filters out peaks in the FOR that are not closely associated with expected Bragg indices. These distant peaks could result from interference, noise, or other non-Bragg sources, potentially leading to erroneous current velocity vectors. This ensures that only physically valid Bragg signals are used in the processing pipeline.

Steps:

1. Retrieve Current FOR Data:

   • Retrieves the detected FOR Doppler bin indices for all range cells using seasonder_getSeaSondeRCS_FOR.

2. Apply Rejection Test:

   • Iterates over each range cell and each Bragg region (positive_FOR and negative_FOR).

   • Calls seasonder_rejectDistantBraggPeakTest for each peak to evaluate its proximity to the Bragg indices.

   • Peaks that fail the test are removed (replaced with an empty vector).

3. Store Updated FOR Data:

   • Updates the SeaSondeRCS object with the filtered FOR results using seasonder_setSeaSondeRCS_FOR.

This function is part of the FOR processing workflow and should be applied after the initial detection of Bragg peaks.

Value

The updated SeaSondeRCS object with the filtered FOR bins.

References

COS. SpectraPlotterMap 12 User Guide. CODAR Ocean Sensors (COS), Mountain View, CA, USA, 2016.

See Also

• seasonder_rejectDistantBraggPeakTest for the peak rejection logic.

• seasonder_getSeaSondeRCS_FOR for retrieving detected FOR bins.

• seasonder_setSeaSondeRCS_FOR for updating FOR data.

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