seasonder_findFORNulls: Identify Nulls in First Order Region (FOR) Across All Range...

In SeaSondeR: Radial Metrics from SeaSonde HF-Radar Data

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

Description

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.

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.

Value

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

See Also

• seasonder_findFORNullsInSpectrum for processing individual spectra.

• seasonder_findFORNullsInSSMatrix for batch processing spectra across multiple range cells.

• seasonder_getSeaSondeRCS_FOR_SS_Smoothed for retrieving smoothed SS data.

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