seasonder_rejectNoiseIonospheric: Apply Noise/Ionospheric Contamination Test to All Bragg Peaks

View source: R/SeaSondeRCS_FOR.R

seasonder_rejectNoiseIonosphericR Documentation

Apply Noise/Ionospheric Contamination Test to All Bragg Peaks

Description

This function evaluates and filters the First Order Region (FOR) detections across all range cells by applying the noise/ionospheric contamination rejection test to both positive and negative Bragg regions.

Usage

seasonder_rejectNoiseIonospheric(seasonder_cs_object)

Arguments

seasonder_cs_object

A SeaSondeRCS object containing the spectral data and FOR parameters.

Details

Reason for the Test: This function ensures that Bragg peaks contaminated by excessive noise or ionospheric interference are removed from the detected First Order Region (FOR). Peaks where the power in the surrounding non-Bragg region exceeds the power in the Bragg region by a specified threshold are deemed invalid and are rejected. This step is critical for maintaining the accuracy of radar-derived measurements.

Steps:

  1. Retrieve Current FOR Data:

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

  2. Apply Noise/Ionospheric Rejection Test:

    • Iterates over each range cell and evaluates both positive and negative Bragg regions.

    • Calls seasonder_rejectNoiseIonosphericTest to check each peak against the noise/ionospheric criterion.

    • 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.

Use Case: This function is particularly useful in environments where noise or ionospheric effects are prevalent, ensuring that only valid first-order Bragg peaks are retained for further processing.

Value

The updated SeaSondeRCS object with the filtered FOR bins.

See Also

  • seasonder_rejectNoiseIonosphericTest for the noise/ionospheric 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.