seasonder_MUSICExtractPeaksCheckRetainedSolution: Validate Retained Solution in MUSIC Algorithm Peak Extraction

In SeaSondeR: Radial Metrics from SeaSonde HF-Radar Data

Validate Retained Solution in MUSIC Algorithm Peak Extraction

Description

This function verifies and adjusts the retained solution type ("single" or "dual") based on the Direction of Arrival (DOA) solutions extracted using the MUSIC algorithm.

Usage

seasonder_MUSICExtractPeaksCheckRetainedSolution(ret_sol, DOA_sol)

Arguments

ret_sol	A character string specifying the initial solution type to retain. Valid values are "single" or "dual".
DOA_sol	A list containing extracted DOA solutions, as returned by seasonder_MUSICExtractDOASolutions.

Details

The function performs the following checks:

1. If the retained solution is "dual" but no valid dual solution bearings exist, it defaults to "single" if valid.

2. If the retained solution is "single" but no valid single solution bearings exist, it defaults to "none".

This validation ensures the output solutions are consistent with the detected peaks, addressing potential discrepancies in the initial assumptions about the solution type.

Value

A character string indicating the validated solution type:

• "single": If only one single solution bearing is valid.

• "dual": If valid dual solution bearings are detected.

• "none": If no valid bearings are found.

See Also

seasonder_MUSICExtractPeaks, seasonder_MUSICExtractDOASolutions

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