an orientation density of an assumed orthotropic texture rotated so that its two fold axes lie on the specimen axes

Syntax

odr, rot, v1, v2 = centerSpecimen(odf)

Starting at the x axis.

odr, rot, v1, v2 = centerSpecimen(odf, yvector, delta=30*degree, verbose=True)

Another start, a smaller search.

Description

The function finds the two fold axes of a texture that should have orthorhombic specimen symmetry but was measured slightly turned, and turns it back. A candidate axis is scored by how much the density changes when turned by 180 degree about it; the fit verbose reports is one minus that change, relative to the norm of the density.

The first axis is searched on a cap of opening delta about v0 and refined, the second on the fan perpendicular to the first. The rotation carries the two axes onto the specimen axes nearest to them; v2 is returned made exactly perpendicular to v1.

The search and the result use the harmonic series of the given bandwidth, so odr is truncated to it. MATLAB’s flags ‘Fourier’ and ‘silent’ change nothing; its ‘SO3Grid’ and ‘resolution’ are not taken.

Input

`odf`	SO3Fun
`v0`	vector3d, the start of the search for the first axis, the x axis by default

Keywords

keyword	default	description
`delta`	`45*degree`	the opening angle of the cap about v0 searched for the first axis
`bandwidth`	`16`	the degree of the harmonic series the search compares
`verbose`	`False`	report the fit of every step

Output

`odr`	SO3FunHarmonic, the rotated density
`rot`	rotation, the rotation applied, odr = rotate(odf, rot)
`v1, v2`	vector3d, the two fold axes found

Used on

DetectionOfSampleSymmetry

MATLAB’s SO3Fun.centerSpecimen

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/SO3Fun.centerSpecimen_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.

SO3Fun.centerSpecimen