rotates an odf with specimen symmetry into its symmetry axes
centerSpecimen(odf,center) tries to find the normal vectors of orthorhombic symmetry for the x mirror and y mirror plane and calculates an rotation needed to rotate the odf back into these mirror planes. the routine starts with a look around grid for a given center (default xvector) to find a starting value for newton iteration.
Syntax
[odf,rot,v1,v2] = centerSpecimen(odf,v0,varargin)Input
| odf | SO3Fun |
| v0 | vector3d initial guess for a symmetry axis (default xvector) |
Output
| odf | rotated SO3Fun |
| rot | rotation such that rotate(odf_out,r) = odf_in |
| v1,v2 | normal vector of the two fold symmetry axes |
Options
| SO3Grid | a SO3Grid where the SO3Fun is evaluated on |
| delta | specifies the opening angle for the initial search grid around input center |
| resolution | specifies the resolution for the initial search grid |
| silent | don't verbose number of initial axes and the newton iteration |
| Fourier | use Fourier coefficients as objective function |
Example
starting with an synthetic odf with orthorhombic symmetry
CS = crystalSymmetry('cubic');
SS = specimenSymmetry('orthorhombic');
ori = [orientation.byEuler(135*degree,45*degree,120*degree,CS,SS) ...
orientation.byEuler( 60*degree, 54.73*degree, 45*degree,CS,SS) ...
orientation.byEuler(70*degree,90*degree,45*degree,CS,SS)...
orientation.byEuler(0*degree,0*degree,0*degree,CS,SS)];odf = unimodalODF(SS*ori);we define a rotational displacement
r2 = rotation.byEuler( 6*degree,4*degree,0*degree);
odf = rotate(odf,r2);
h = [Miller(0,0,1,CS),Miller(0,1,1,CS),Miller(1,1,1,CS)];
plotPDF(odf,h,'antipodal','complete','upper');Warning: Rotating an ODF with specimen symmetry will remove the specimen
symmetry
lets try to retrieve the original orthorhombic odf back
[odr,r,v1,v2] = centerSpecimen(odf);
plotPDF(odr,h,'antipodal')
See also
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/SO3Fun.centerSpecimen.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.