Identify Nulls in First Order Region (FOR) for a Self-Spectra Matrix
Source:R/SeaSondeRCS_FOR.R
seasonder_findFORNullsInSSMatrix.Rd
This 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
SeaSondeRCS
object 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
SS
matrix.Extract the power spectrum for the corresponding range cell.
Apply
seasonder_findFORNullsInSpectrum
to determine the null positions.Store the results in a named list, where each entry corresponds to a range cell.
See also
seasonder_findFORNullsInSpectrum
for detecting nulls in a single spectrum.seasonder_findFORNulls
for high-level null detection across all spectra.