Skip to contents

Validate Eigenvalue Ratio Using MUSIC Algorithm

Source: R/SeaSondeRCS_MUSIC.R
seasonder_MUSICCheckEigenValueRatio.Rd

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.

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.

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."

See also

seasonder_getSeaSondeRCS_MUSIC, seasonder_setSeaSondeRCS_MUSIC