seasonder_MUSICCheckEigenValueRatio: Validate Eigenvalue Ratio Using MUSIC Algorithm

In SeaSondeR: Radial Metrics from SeaSonde HF-Radar Data

Validate Eigenvalue Ratio Using MUSIC Algorithm

Description

This function implements the P1 test for solutions derived using the MUSIC algorithm. The test checks the ratio between the largest and the second-largest eigenvalues, which serves as an indicator of signal quality.

Usage

seasonder_MUSICCheckEigenValueRatio(seasonder_cs_object)

Arguments

seasonder_cs_object

A SeaSondeRCS object containing the MUSIC solutions and related data.

Details

The P1 test is based on the ratio of the largest eigenvalue (lambda1) to the second-largest eigenvalue (lambda2):

Ratio = lambda1 / lambda2

This ratio is compared to a threshold defined in the MUSIC parameters to determine whether the solution is considered valid. Solutions failing this test are marked as "single."

Value

The updated SeaSondeRCS object with the following modifications:

• A new column eigen_values_ratio in the MUSIC data.

• A logical column P1_check indicating whether each solution passes the P1 test.

• Updated retained_solution values for solutions that fail the test.

See Also

seasonder_getSeaSondeRCS_MUSIC, seasonder_setSeaSondeRCS_MUSIC

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