seasonder_runMUSIC {SeaSondeR}R Documentation

Execute the MUSIC Algorithm on a SeaSondeRCS Object

Description

This function performs the MUSIC (MUltiple SIgnal Classification) algorithm on a given SeaSondeRCS object, executing a series of processing steps to extract direction-of-arrival (DOA) information and other related metrics from the radar cross-spectrum data.

Usage

seasonder_runMUSIC(seasonder_cs_object)

Arguments

seasonder_cs_object

A SeaSondeRCS object that contains the radar cross-spectrum data and metadata. This object is modified in place to include the results of the MUSIC algorithm.

Details

The MUSIC algorithm is executed in a series of sequential steps:

  1. Log the start of the MUSIC algorithm.

  2. Update the processing steps of the SeaSondeRCS object to include the MUSIC start text.

  3. Perform the following computations:

    • Compute the covariance matrix from the cross-spectrum data.

    • Perform eigen decomposition on the covariance matrix.

    • Compute the DOA functions using MUSIC-specific methods.

    • Extract peaks from the DOA functions, corresponding to possible signal directions.

    • Calculate the signal power matrix.

    • Test for dual solutions and compute their proportions.

    • Select the final set of DOAs from the computed data.

    • Convert the selected DOAs to geographical coordinates (latitude and longitude).

  4. Log the completion of the MUSIC algorithm.

Value

A SeaSondeRCS object with updated MUSIC-related attributes. Specifically:

See Also

seasonder_MUSICComputeCov: Compute the covariance matrix. seasonder_MUSICCovDecomposition: Perform eigen decomposition of the covariance matrix. seasonder_MUSICComputeDOAProjections: Compute the direction-of-arrival functions. seasonder_MUSICExtractPeaks: Extract peaks from the DOA functions. seasonder_MUSICComputeSignalPowerMatrix: Calculate the signal power matrix. seasonder_MUSICTestDualSolutions: Test and analyze dual solutions in the DOA. seasonder_MUSICComputePropDualSols: Compute proportions for dual solutions. seasonder_MUSICSelectDOA: Select final DOA estimations. seasonder_MUSIC_LonLat: Convert DOA estimations to geographical coordinates.

Examples


# Prepare a SeaSondeRCS object with MUSIC data
apm_file <- system.file("css_data/MeasPattern.txt", package = "SeaSondeR")
apm_obj <- seasonder_readSeaSondeRAPMFile(apm_file)
cs_file <- system.file("css_data/CSS_TORA_24_04_04_0700.cs", package = "SeaSondeR")
cs_obj <- seasonder_createSeaSondeRCS(cs_file, seasonder_apm_object = apm_obj)
cs_obj <- seasonder_initMUSICData(cs_obj)
cs_obj <- seasonder_initMUSICData(
 cs_obj,
 range_cells = c(rep(5,11), rep(4,11)),
 doppler_bins = c(c(669:679),c(674:684))
)
cs_obj <- seasonder_SeaSondeRCSMUSICInterpolateDoppler(cs_obj)
# Run the MUSIC algorithm
cs_obj <- seasonder_runMUSIC(cs_obj)
# Check the updated processing steps
print(seasonder_getSeaSondeRCS_ProcessingSteps(cs_obj))


[Package SeaSondeR version 0.2.8 Index]