the child grains whose vote is clear turned into parent grains, the parent orientation of the variant they voted for; MATLAB’s calcParentFromVote

Syntax

job.calcParentFromVote()

Every grain with a vote.

job.calcParentFromVote(minProb=0.7)

A probability of at least 0.7.

job.calcParentFromVote(minProb=0.5, minDelta=0.2)

And ahead of the second by 0.2.

job.calcParentFromVote(minFit=2*degree, minDelta=1*degree)

After votes of the best fit.

job.calcParentFromVote(minCount=3, maxCount=1)

After counted votes.

Description

The votes are those of the last calcGBVotes, calcTPVotes or clusterVariantGraph, and the criteria read them as they are: probabilities with minProb, minDelta and minAlpha, fits of bestFit with minFit, minDelta and minAlpha, counts with minCount and maxCount. A grain that meets them takes the parent phase and the parent orientation of the variant it voted for; a grain that is a parent already is reconstructed again from its measured orientation, a merged parent grain is not. The votes of the grains turned are cleared.

MATLAB documents minVotes, which neither MATLAB nor this port reads; minAlpha compares fits, as MATLAB’s code does, not probabilities, as its help says.

Input

job parentGrainReconstructor, with job.votes

Keywords

keyword	default	description
`minProb`	`0`	with probabilities: the best must exceed this
`minDelta`	`None`	the best must lead the second by more than this: in probability, or in angle with fits
`minFit`	`5*degree`	with fits: the best must be below this angle
`minAlpha`	`None`	with fits: the best must exceed this factor times the second
`minCount`	`0`	with counts: the best must reach this count
`maxCount`	`None`	with counts: the second must stay below this count

References

F. Niessen, T. Nyyssönen, A. A. Gazder, R. Hielscher, Parent grain reconstruction from partially or fully transformed microstructures in MTEX, J. Appl. Cryst. 55 (2022) 180-194

Used on

GrainGraphBasedReconstruction, MaParentGrainReconstruction, TiBetaReconstruction, TriplePointBasedReconstruction

MATLAB’s parentGrainReconstructor.calcParentFromVote

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/parentGrainReconstructor.calcParentFromVote_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.

parentGrainReconstructor.calcParentFromVote