grain2d.transform edit page

apply an arbitrary spatial transformation to a grain map

Applies fun to every vertex of the grain boundaries, leaving mean orientations, phase and all other properties untouched. Unlike rotate, fun need not be a rigid transformation - it may be any map from position to position. Since all grain boundary quantities (vertices, boundary segments, triple points, ...) are derived from the same underlying vertex list, transforming it is enough to keep the whole grain map consistent.

Useful together with EBSD/transform to check that reconstructing grains commutes with a spatial transformation, i.e. that calcGrains on a transformed EBSD map agrees with transforming the grains reconstructed from the untransformed map.

Syntax

grainsT = transform(grains,fun)

Input

grains grain2d
fun function handle, vector3d -> vector3d, or a spatialTransform

Output

grains grain2d with transformed vertices

See also

grain2d.rotate EBSD.transform spatialTransform

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/grain2d.transform.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.