StratigrapheR (version 0.0.2)

rmatrix: 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<U+00B0> (Tauxe 2010).

inc

inclination of the rotation axis; it is the angle from the horizontal, is positive downward, and ranges from +90<U+00B0> for straight down to -90<U+00B0> 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

# NOT RUN {
rmatrix(135,20,60)

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

# }