Extract First Order Region (FOR) Spectral Data

This function extracts the spectral power corresponding to the First Order Region (FOR) from a given self-spectra (SS) matrix. It retrieves the spectral values within the Doppler bins identified as part of the positive and negative Bragg regions.

Usage

seasonder_extractFOR(seasonder_cs_object, spectrum, FOR)

Arguments

seasonder_cs_object

A SeaSondeRCS object containing the spectral data.

spectrum

A numeric matrix representing the self-spectra data for a single range cell.

FOR

A list containing the Doppler bin indices defining the FOR region, with two elements: - negative_FOR: A numeric vector of Doppler bins for the negative Bragg region. - positive_FOR: A numeric vector of Doppler bins for the positive Bragg region.

Value

A list with two elements:

• negative_FOR: A matrix containing spectral power for the negative Bragg region.

• positive_FOR: A matrix containing spectral power for the positive Bragg region.

Details

The function performs the following steps:

1. Initialize Empty Matrices: Creates empty matrices to store extracted spectral data.

2. Extract Negative FOR Data:

   • If the negative FOR bins exist, calls seasonder_extractSeaSondeRCS_dopplerRanges_from_SSdata to extract the corresponding spectral values.

3. Extract Positive FOR Data:

   • If the positive FOR bins exist, extracts the spectral values using the same function.

4. Return Extracted Spectral Data: Outputs a list containing the extracted negative and positive Bragg region spectral data.

This function is primarily used for filtering and validating the first-order Bragg region in SeaSonde radar processing.

See also

• seasonder_extractSeaSondeRCS_dopplerRanges_from_SSdata for extracting Doppler bin subsets.

• seasonder_filterFORAmplitudes for filtering weak FOR detections.