rotations (version 0.1)

UARS: Generic UARS Distribution

Description

Density, distribution function and random generation for the the generic uniform axis-random spin (UARS) class of distributions.

Usage

duars(R, dangle, S = id.SO3, kappa = 1, ...)
  puars(R, pangle, S = id.SO3, kappa = 1, ...)
  ruars(n, rangle, S = NULL, kappa = 1, space = "SO3", ...)

Arguments

R

Value at which to evaluate the UARS density.

n

number of observations. If length(n)>1, the length is taken to be the number required.

dangle

The function to evaluate the angles from e.g. dcayley, dvmises, dfisher, dhaar.

pangle

The form of the angular density e.g. pcayley, pvmises, pfisher, phaar.

rangle

The function from which to simulate angles e.g. rcayley, rvmises, rhaar, rfisher.

S

central orientation of the distribution.

kappa

concentration parameter.

space

indicates the desired representation: matrix ("SO3") or quaternion ("Q4").

...

additional arguments.

Value

• duars
  gives the density
• puars
  gives the distribution function
• ruars
  generates random deviates

Details

For the rotation R with central orientation S and concentration $kappa$ the UARS density is given by $$f(R|S,\kappa)=\frac{4\pi}{3-tr(S^\top R)}C(acos[tr(S^\top R)-1]/2|\kappa)$$ where $C(r|\kappa)$ is one of the Angular-distributions.

References

Bingham M, Nordman D and Vardeman S (2009). "Modeling and Inference for Measured Crystal Orientations and a Tractable Class of Symmetric Distributions for Rotations in three Dimensions." Journal of the American Statistical Association, 104(488), pp. 1385-1397.

See Also

For more on the angular distribution options see Angular-distributions.