A method of orientation.

the same orientation described with another reference frame of the crystal

Syntax

ori = ori.transformReferenceFrame(cs)

The axes aligned by the frames’ conventions.

ori = ori.transformReferenceFrame(cs, rule=rel)

The frames related by an orientation.

ori = ori.transformReferenceFrame(cs, 'byScreenAlignment')

The frames related by their plotting conventions.

mori = mori.transformReferenceFrame(cs1, cs2)

Both frames of a misorientation.

Description

An orientation is described with respect to Cartesian axes aligned in a fixed way with the crystal axes a, b, c, such as X||a, Z||c* or X||a*, Z||c. The orientation, the physical relation between crystal and specimen, stays, only its coordinates change: ori’ = ori * inv(R), R the transition from the old crystal frame to the new one, so ori’(h’) = ori(h) for every crystal direction h restated as h’.

Input

ori orientation
to crystalFrame, the new frame, the first one of a misorientation
toB crystalFrame, the new second frame of a misorientation; or the rule

Keywords

keyword default description
rule None how the old frame relates to the new one: ‘byAxes’, by the crystal axes, the default; ‘byScreenAlignment’, by the two frames being drawn alike; or an orientation from the old frame to the new one
tol 0.1 how far from a rotation the transition by the axes may come out

Output

ori orientation in the new frame

See also

vector3d.transformReferenceFrame, align, byScreenAlignment, CrystalReferenceSystem

MATLAB’s orientation.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.transformReferenceFrame_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.