A method of fibre.

the fibre that fits a list of orientations best, MATLAB’s fibre.fit

Syntax

f = fibre.fit(ori)

The fibre through the orientations.

f, lam, delta = fibre.fit(ori, diagnostics=True)

With the eigenvalues and the mean angle.

f = fibre.fit(ori, symmetry=False)

The orientations as stored.

Description

The fibre is the plane of the two leading eigenvectors of the quaternion tensor of the orientations, after they are moved to the symmetric equivalents nearest their mean. This is MATLAB’s ‘local’ fit of a concentrated cloud, the one algorithm here; MATLAB’s fit to an ODF is not taken. The result is a full fibre, with r in the upper hemisphere.

Input

ori orientation
args ‘local’, MATLAB’s flag, accepted

Keywords

keyword default description
diagnostics False also return lam and delta, MATLAB’s second and third outputs
symmetry True move the orientations to the equivalents nearest their mean first; False takes them as stored

Output

f fibre, full
lam the eigenvalues of the quaternion tensor, ascending and summing to one (diagnostics)
delta the mean angle of the orientations to the fibre (diagnostics)

See also

fibre.angle, orientation.mean

MATLAB’s fibre.fit

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/fibre.fit_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.