EBSDsquare.transformReferenceFrame edit page

store a gridded map in a given matrix layout

Description

A gridded map has a layout of its own - the row index advances along d1 and the column index along d2 - and this puts it into another one. Nothing is resampled and no value is invented: a transpose and two flips are all that is ever applied, so a layout no permutation can reach is approached as closely as one can, the same way gridify does.

NB this changes the SHAPE of the map whenever the two layouts differ by a quarter turn - an r × c map comes back c × r.

Syntax

ebsd = transformReferenceFrame(ebsd,gridLayout(yvector,xvector))
ebsd = transformReferenceFrame(ebsd,gridLayout(otherMap))
[ebsd,newId] = transformReferenceFrame(ebsd,gL)

Input

ebsd EBSDsquare
gL gridLayout the matrix indices are to advance along

Output

ebsd EBSDsquare, the same data reindexed
newId where each element of the old matrix sits in the new one

See also

EBSD.gridify gridLayout.layoutIndex EBSDsquare.rotate

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/EBSDsquare.transformReferenceFrame.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.