Skip to contents

Calculate Doppler Bins Frequencies for MUSIC Analysis

Source: R/SeaSondeRCS_MUSIC.R
seasonder_getSeaSondeRCS_MUSIC_DopplerBinsFrequency.Rd

This function computes the Doppler bin frequencies for a given SeaSondeRCS object, incorporating adjustments from the MUSIC analysis. The computation accounts for Doppler interpolation and the spectrum resolution.

Usage

seasonder_getSeaSondeRCS_MUSIC_DopplerBinsFrequency(
  seasonder_cs_object,
  normalized = FALSE
)

Arguments

seasonder_cs_object

A SeaSondeRCS object containing the data and parameters for MUSIC analysis.

normalized

Logical. If TRUE, the returned frequencies are normalized by the positive Bragg frequency. Default is FALSE, returning frequencies in Hz.

Value

A numeric vector representing the frequency values for each Doppler bin. If normalized = TRUE, these values are dimensionless, relative to the positive Bragg frequency. Otherwise, they are in Hz.

Details

The function performs the following steps:

  1. Retrieves the central Doppler bin corresponding to 0 frequency using seasonder_getSeaSondeRCS_MUSIC_CenterDopplerBin.

  2. Retrieves the total number of Doppler cells (adjusted for interpolation) using seasonder_getSeaSondeRCS_MUSIC_nDopplerCells.

  3. Retrieves the Doppler spectrum resolution using seasonder_getSeaSondeRCS_MUSIC_DopplerSpectrumResolution.

  4. Computes the Doppler bin frequencies using seasonder_computeDopplerBinsFrequency.

The resulting Doppler bins frequencies are crucial for analyzing the spectral properties of the MUSIC output.

See also

seasonder_getSeaSondeRCS_MUSIC_CenterDopplerBin to retrieve the central bin. seasonder_getSeaSondeRCS_MUSIC_nDopplerCells for the number of Doppler cells. seasonder_getSeaSondeRCS_MUSIC_DopplerSpectrumResolution for the adjusted spectrum resolution. seasonder_computeDopplerBinsFrequency for the frequency calculation.