seasonder_findFORNullsInSSMatrix: Identify Nulls in First Order Region (FOR) for a Self-Spectra...

In SeaSondeR: Radial Metrics from SeaSonde HF-Radar Data

Identify Nulls in First Order Region (FOR) for a Self-Spectra Matrix

Description

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.

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:

1. Iterate through each row of the SS matrix.

2. Extract the power spectrum for the corresponding range cell.

3. Apply seasonder_findFORNullsInSpectrum to determine the null positions.

4. Store the results in a named list, where each entry corresponds to a range cell.

Value

A named list where each entry corresponds to a range cell, containing the detected FOR null positions.

See Also

• seasonder_findFORNullsInSpectrum for detecting nulls in a single spectrum.

• seasonder_findFORNulls for high-level null detection across all spectra.

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