enuToOtherAdp: Convert adp Object from ENU Coordinate to Rotated Coordinate

In oce: Analysis of Oceanographic Data

Convert adp Object from ENU Coordinate to Rotated Coordinate

Description

Convert ADP velocity components from an enu-based coordinate system to another system, perhaps to align axes with the coastline.

Usage

enuToOtherAdp(x, heading = 0, pitch = 0, roll = 0)

Arguments

x	an adp object.
heading	number or vector of numbers, giving the angle, in degrees, to be added to the heading. See “Details”.
pitch	as heading but for pitch.
roll	as heading but for roll.

Details

The supplied angles specify rotations to be made around the axes for which heading, pitch, and roll are defined. For example, an eastward current will point southeast if heading=45 is used.

The returned value has heading, pitch, and roll matching those of x, so these angles retain their meaning as the instrument orientation.

NOTE: this function works similarly to xyzToEnuAdp(), except that in the present function, it makes no difference whether the instrument points up or down, etc.

Value

An object with data$v[,1:3,] altered appropriately, and metadata$oce.coordinate changed from enu to other.

Author(s)

Dan Kelley

References

1. Teledyne RD Instruments. “ADCP Coordinate Transformation: Formulas and Calculations,” January 2010. P/N 951-6079-00.

See Also

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

Other things related to adp data: [[,adp-method, [[<-,adp-method, ad2cpCodeToName(), ad2cpHeaderValue(), adp, adp-class, adpAd2cpFileTrim(), adpConvertRawToNumeric(), adpEnsembleAverage(), adpFlagPastBoundary(), adpRdiFileTrim(), adp_rdi.000, applyMagneticDeclination,adp-method, as.adp(), beamName(), beamToXyz(), beamToXyzAdp(), beamToXyzAdpAD2CP(), beamToXyzAdv(), beamUnspreadAdp(), binmapAdp(), enuToOther(), handleFlags,adp-method, is.ad2cp(), plot,adp-method, read.adp(), read.adp.ad2cp(), read.adp.nortek(), read.adp.rdi(), read.adp.sontek(), read.adp.sontek.serial(), read.aquadopp(), read.aquadoppHR(), read.aquadoppProfiler(), rotateAboutZ(), setFlags,adp-method, subset,adp-method, subtractBottomVelocity(), summary,adp-method, toEnu(), toEnuAdp(), velocityStatistics(), xyzToEnu(), xyzToEnuAdp(), xyzToEnuAdpAD2CP()

Examples

library(oce)
data(adp)
o <- enuToOtherAdp(adp, heading = -31.5)
plot(o, which = 1:3)

oce documentation built on Sept. 11, 2024, 7:09 p.m.