seasonder_MUSICCheckSignalPowers: Validate Signal Power Ratios Using MUSIC Algorithm

View source: R/SeaSondeRCS_MUSIC.R

seasonder_MUSICCheckSignalPowersR Documentation

Validate Signal Power Ratios Using MUSIC Algorithm

Description

This function implements the P2 test for solutions derived using the MUSIC algorithm. The test evaluates the ratio between the largest and smallest signal powers for dual-bearing solutions.

Usage

seasonder_MUSICCheckSignalPowers(seasonder_cs_object)

Arguments

seasonder_cs_object

A SeaSondeRCS object containing the MUSIC solutions and related data.

Details

The P2 test is based on the ratio of the largest signal power (P_{max}) to the smallest signal power (P_{min}):

Ratio = \frac{P_{max}}{P_{min}}

This ratio is compared to a threshold defined in the MUSIC parameters. Only solutions that meet the following criteria are retained:

  • The solution has two bearings.

  • The signal power ratio is below the threshold.

Solutions failing this test are marked as "single."

Value

The updated SeaSondeRCS object with the following modifications:

  • A new column signal_power_ratio in the MUSIC data.

  • A logical column P2_check indicating whether each solution passes the P2 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.