seasonder_MUSICCheckEigenValueRatio {SeaSondeR} | R Documentation |
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