Skip to contents

Identify Nulls in First Order Region (FOR) Across All Range Cells

Source: R/SeaSondeRCS_FOR.R
seasonder_findFORNulls.Rd

This function locates the null points in the First Order Region (FOR) of a SeaSondeR cross-spectral object. It smooths the self-spectra (SS) data, extracts the relevant Doppler bins, and determines the boundaries of the first-order Bragg region for each range cell.

Usage

seasonder_findFORNulls(seasonder_cs_object)

Arguments

seasonder_cs_object

A SeaSondeRCS object containing spectral data and FOR parameters.

Value

The updated SeaSondeRCS object with the computed FOR nulls, maximum power, and bin indices.

Details

The function follows these steps:

  1. Smooth the Self-Spectra Data: Calls seasonder_SmoothFORSS to apply a running mean filter.

  2. Extract Smoothed Self-Spectra: Retrieves the processed SS matrix using seasonder_getSeaSondeRCS_FOR_SS_Smoothed.

  3. Identify the Doppler Center Bin: Determines the central Doppler bin using seasonder_getCenterDopplerBin.

  4. Segment the Spectrum: Splits the smoothed SS data into:

    • The negative Bragg region (left side of the Doppler spectrum).

    • The positive Bragg region (right side of the Doppler spectrum).

  5. Find Nulls in Each Region: Uses seasonder_findFORNullsInSSMatrix to identify the null positions.

  6. Store Results: Extracts:

    • The First Order Region (FOR).

    • The maximum power (MAXP).

    • The Doppler bin index of the maximum power (MAXP.bin).

  7. Update the SeaSondeRCS Object: Saves the detected FOR boundaries and related metrics.

See also