rmatrix: Rotation matrix

View source: R/rmatrix.R

rmatrixR Documentation

Rotation matrix

Description

Computes a rotation matrix for a given rotation axis and angle based on Tauxe et al. (2010).

Usage

rmatrix(dec, inc, mag, as.data.frame = FALSE)

Arguments

dec

declination of the rotation axis; it is the angle from the north taken on an horizontal plane. It is measured clockwise from North and ranges from 0 to 360° (Tauxe 2010).

inc

inclination of the rotation axis; it is the angle from the horizontal, is positive downward, and ranges from +90° for straight down to -90° for straight up (Tauxe, 2010).

mag

magnitude of rotation (following the notation of the Stereonet software) a positive rotation is clockwise looking in the direction of the given declination and inclination)

as.data.frame

logical, whether to output the matrix as a data frame. This is used when multiple arguments are provided to simplify and boost calculations.

References

  • Tauxe, L., 2010. Essentials of Paleomagnetism. University of California Press.

  • Allmendinger, R. W., Cardozo, N. C., and Fisher, D., 2013, Structural Geology Algorithms: Vectors & Tensors: Cambridge, England, Cambridge University Press, 289 pp.

  • Cardozo, N., and Allmendinger, R. W., 2013, Spherical projections with OSXStereonet: Computers & Geosciences, v. 51, no. 0, p. 193 - 205, doi: 10.1016/j.cageo.2012.07.021

Examples

rmatrix(135,20,60)

rmatrix(c(135,0),c(20,90),c(60,90), as.data.frame = TRUE)


StratigrapheR documentation built on July 9, 2023, 6:02 p.m.