A method of orientation.

the orientation two frames stand in by their axes, MATLAB’s orientation.align

Syntax

ori = orientation.align(cs1, cs2)

The rotation from the axes of cs1 to those of cs2.

ori = orientation.align(cs1, cs2, tol=1e-3)

A transition nearer a rotation demanded.

Description

A point sitting at v in frA sits at ori * v in frB. Unlike orientation.byScreenAlignment, which infers the rotation from how the two frames are drawn, this reads the two bases: it is the rotation of referenceFrame.transformationMatrix, which vector3d.transformReferenceFrame applies to move data from one frame into the other. The orientation is between the frames without their groups (stripSym).

Input

frA referenceFrame, the source
frB referenceFrame, the target

Keywords

keyword default description
tol 0.1 how far, as the norm of I - M M’, the transition M may be from a rotation; a larger deviation is refused

Output

ori orientation from frA to frB

See also

orientation.byScreenAlignment, referenceFrame.isCompatible, transformReferenceFrame

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.align_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.