oce (version 0.1-81)

adp.xyz2enu: Convert ADP from xyz coordinates to enu coordinates

Description

Convert ADP velocity components from a xyz-based coordinate system to an enu-based coordinate system, by using the instrument's recording of heading, pitch, and roll.

Usage

adp.xyz2enu(x, declination=0, debug=getOption("oce.debug"))

Arguments

x

an object of class "adp".

declination

magnetic declination to be added to the heading, to get ENU with N as "true" north.

debug

a flag that turns on debugging. Set to 1 to get a moderate amount of debugging information, or to 2 to get more.

Value

• An object with the data$ma$v[,1:3,] altered appropriately, and with metadata$oce.orientation changed from xyz to enu.

Details

Different formulae are used for different instruments.

A few notes are in order for RDI instruments, for which this code was originally written, and which is well tested. The beams are rotated using formulae from page 13 and 14 of RD Instruments (1998). If a heading bias was set for the deployment (e.g. by using the EB command in the RDI setup system), then this will be subtracted from the heading, as the file is read.

References

RD Instruments, 1998. ADCP Coordinate Transformation, formulas and calculations. P/N 951-6079-00 (July 1998).

See Also

See read.adp for other functions that relate to objects of class "adp".