A method of PoleFigure.
the pole figures of the deviation from a recalculation: the difference between measured intensities and those an ODF predicts, or another pole figure on the same directions; MATLAB’s calcErrorPF
Syntax
pfe = calcErrorPF(pf, odf)
The damped relative error.
pfe = calcErrorPF(pf, pf2)
Against other pole figures.
pfe = pf.calcErrorPF(odf, 'RP', epsilon=0.5)
| pf - pfcalc | / pfcalc where pfcalc > 0.5. |
pfe = pf.calcErrorPF(odf, 'l1')
| pf - pfcalc | . |
pfe = pf.calcErrorPF(odf, 'l2')
| pf - pfcalc | ^2. |
Description
The recalculation is first scaled to the mass of the measurement by calcNormalization. ‘relative’, the default, is |I - Ic| / max(I + epsilon, Ic + epsilon), which MATLAB computes when no measure is named, though its help names RP the default; ‘RP’ keeps only the directions where the recalculation exceeds epsilon, so its pole figures have fewer directions; ‘l1’ and ‘l2’ are the plain differences. The names are taken in any case.
Input
pf |
PoleFigure, the measurement |
other |
SO3Fun, the ODF of the recalculation, or PoleFigure on the same directions |
Keywords
| keyword | default | description |
|---|---|---|
mode |
'relative' |
‘relative’, ‘RP’, ‘l1’ or ‘l2’ |
epsilon |
None |
the damping of ‘relative’ (0.5) or the threshold of ‘RP’ (1), both times the normalisation |
Output
pfe |
PoleFigure of the deviations |
See also
PoleFigure.calcError, calcNormalization, calcPoleFigure
MATLAB’s PoleFigure.calcErrorPF
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/PoleFigure.calcErrorPF_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.