A method of orientation.

the rotation a tangent vector at this reference points to, exp(ori, v) of MATLAB

Syntax

rot = exp(rotRef, v)

V a rotation vector in the specimen’s coordinates.

ori = exp(oriRef, Miller(...))

A crystal direction, taken on the right.

ori = exp(oriRef, v, side='right')

V in the crystal’s coordinates.

Description

The exponential map: the rotation exp(v) * ref on the left side, ref * exp(v) on the right, so that log(exp(ref, v), ref) is v again. An SO3TangentVector carries its own reference and side, and this reference is ignored. The vectors and the references must have one shape; they do not broadcast.

Input

ref rotation or orientation, the reference
v vector3d, a rotation vector, or an SO3TangentVector

Keywords

keyword default description
side None ‘left’ or ‘right’; by default right for a vector in a crystal frame, left otherwise

Output

rot rotation or orientation of the frames of the reference

See also

quaternion.log, vector3d.exp, SO3TangentVector

MATLAB’s orientation.exp

source

Citing this page. This page is part of the documentation of MTEX, a free and open source MATLAB toolbox for analyzing and modeling crystallographic textures. It was written by The MTEX Developers and is published at https://mtex-toolbox.github.io/orientation.exp_py.html. If you use MTEX, or reuse text or figures from this page, in your research, please cite

F. Bachmann, R. Hielscher, H. Schaeben: Texture Analysis with MTEX - Free and Open Source Software Toolbox, Solid State Phenomena 160 (2010), 63-68. 10.4028/www.scientific.net/SSP.160.63

BibTeX 
@article{bachmann2010mtex,
  author  = {F. Bachmann and R. Hielscher and H. Schaeben},
  title   = {Texture Analysis with MTEX - Free and Open Source Software Toolbox},
  journal = {Solid State Phenomena},
  volume  = {160},
  pages   = {63-68},
  year    = {2010},
  doi     = {10.4028/www.scientific.net/SSP.160.63},
  url     = {https://doi.org/10.4028/www.scientific.net/SSP.160.63}
}

Other papers describing specific MTEX methods are listed under Publications — please cite the one that best fits your application. The MTEX source code is licensed under the GNU General Public License v2.0; the text and figures of this documentation are licensed under CC BY 4.0, which permits reuse — including by automated systems — provided The MTEX Developers and this page are credited.