Identify Nulls in First Order Region (FOR) for a Self-Spectra Matrix
Source:R/SeaSondeRCS_FOR.R
      seasonder_findFORNullsInSSMatrix.RdThis function applies the null-finding algorithm to each row of a self-spectra (SS) matrix, determining the boundaries of the First Order Region (FOR) for each range cell.
Usage
seasonder_findFORNullsInSSMatrix(
  seasonder_cs_object,
  SS,
  doppler_bins,
  negative_Bragg_region = FALSE
)Arguments
- seasonder_cs_object
- A - SeaSondeRCSobject containing spectral data and FOR parameters.
- SS
- A numeric matrix representing the self-spectra data, where rows correspond to range cells and columns correspond to Doppler bins. 
- doppler_bins
- A numeric vector indicating the Doppler bins corresponding to the columns of - SS.
- negative_Bragg_region
- A logical value indicating whether to analyze the negative Bragg region. Default is - FALSE.
Value
A named list where each entry corresponds to a range cell, containing the detected FOR null positions.
Details
This function processes each row of the self-spectra matrix, treating each row as an independent spectrum for which the FOR nulls are identified. The nulls define the boundaries of the first-order Bragg region.
Processing Steps:
- Iterate through each row of the - SSmatrix.
- Extract the power spectrum for the corresponding range cell. 
- Apply - seasonder_findFORNullsInSpectrumto determine the null positions.
- Store the results in a named list, where each entry corresponds to a range cell. 
See also
- seasonder_findFORNullsInSpectrumfor detecting nulls in a single spectrum.
- seasonder_findFORNullsfor high-level null detection across all spectra.