Skip to contents

Convert MUSIC Bearings to Geographic Bearings

Source: R/SeaSondeRCS_MUSIC.R
seasonder_MUSICBearing2GeographicalBearing.Rd

This function converts MUSIC bearings (relative to the antenna) into geographic bearings using the antenna's bearing information from a SeaSondeRAPM object.

Usage

seasonder_MUSICBearing2GeographicalBearing(bearings, seasonder_apm_object)

Arguments

bearings

A list of numeric vectors containing MUSIC bearings in degrees. Each vector corresponds to a set of bearings relative to the antenna.

seasonder_apm_object

A SeaSondeRAPM object containing the antenna's metadata, including the antenna's bearing.

Value

A list of numeric vectors containing the geographic bearings in degrees.

Details

The geographic bearing is calculated by:

  1. Multiplying the MUSIC bearings by -1 to invert their direction.

  2. Adjusting the angles to the range [0, 360) using modulo 360.

  3. Adding the antenna bearing to each value and wrapping the result to the range [0, 360) again using modulo 360.

The formula for each bearing is: \(geo_bearing = ((-1 * music_bearing \\\%\\\% 360) + antenna_bearing) \\\%\\\% 360\).

See also