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 |
Details
The MUSIC algorithm is executed in a series of sequential steps:
Log the start of the MUSIC algorithm.
Update the processing steps of the
SeaSondeRCS
object to include the MUSIC start text.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).
Log the completion of the MUSIC algorithm.
Value
A SeaSondeRCS
object with updated MUSIC-related attributes. Specifically:
Processing steps annotated with the MUSIC start and end points.
Updated attributes and fields for covariance matrix computations, DOA estimations, and other MUSIC-related metrics.
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))