seasonder_SeaSondeRCSExportFORBoundaries: Export First Order Region (FOR) Boundaries

In SeaSondeR: Radial Metrics from SeaSonde HF-Radar Data

Export First Order Region (FOR) Boundaries

Description

This function exports the boundaries of the First Order Region (FOR) for each range cell from a SeaSondeRCS object, providing the first and last Doppler bins for both negative and positive Bragg regions.

Usage

seasonder_SeaSondeRCSExportFORBoundaries(seasonder_cs_object)

Arguments

seasonder_cs_object

A SeaSondeRCS object containing the computed FOR data.

Details

Purpose: This function retrieves the computed FOR data from the SeaSondeRCS object and extracts the boundary Doppler bins for each range cell. The result is a data frame with the following columns:

• range_cell: The index of the range cell.

• first_neg_doppler_cell: The first Doppler bin in the negative Bragg region.

• last_neg_doppler_cell: The last Doppler bin in the negative Bragg region.

• first_pos_doppler_cell: The first Doppler bin in the positive Bragg region.

• last_pos_doppler_cell: The last Doppler bin in the positive Bragg region.

Steps:

1. Retrieve the FOR data using seasonder_getSeaSondeRCS_FOR.

2. Iterate through each range cell and extract the Doppler bins for both negative and positive Bragg regions.

3. Determine the range (first and last bins) for each region.

4. Combine the results into a single data frame, omitting empty entries.

Use Case: This function is useful for exporting the computed FOR boundaries to a format that can be further analyzed or visualized.

Value

A data frame with the boundaries of the FOR for each range cell.

See Also

• seasonder_getSeaSondeRCS_FOR for retrieving the FOR data.

Examples

# Set sample file paths
cs_file <- system.file("css_data/CSS_TORA_24_04_04_0700.cs", package = "SeaSondeR")
apm_file <- system.file("css_data/MeasPattern.txt", package = "SeaSondeR")
# Read the antenna pattern file to create a SeaSondeRAPM object
apm_obj <- seasonder_readSeaSondeRAPMFile(apm_file)
# Create a SeaSondeRCS object from a spectral file
cs_obj <- seasonder_createSeaSondeRCS(cs_file, seasonder_apm_object = apm_obj)
boundaries <- seasonder_SeaSondeRCSExportFORBoundaries(cs_obj)
head(boundaries)

SeaSondeR documentation built on June 8, 2025, 10:50 a.m.