the votes the grain boundaries cast for the parent orientation of their child grains, written into job.votes; MATLAB’s calcGBVotes

Syntax

job.calcGBVotes()

From the child to child and the parent to child boundaries.

job.calcGBVotes(p2c=True, threshold=2.5*degree, tol=1.5*degree)

From the parent to child boundaries alone.

job.calcGBVotes(p2c=True, reconsiderAll=True, threshold=4*degree, tol=1.5*degree)

Every measured child grain anew, the growth step.

job.calcGBVotes(numFit=1, bestFit=True)

The best fit per variant instead of a probability.

job.calcGBVotes(count=True)

The number of fits below the threshold.

Description

A pair of neighbouring child grains votes for the numFit pairs of variants that let both come from one parent, a child grain next to a parent grain for the numFit variants of that parent that fit it. A fit becomes a probability that it still means one parent: 1 below threshold - tol/2, 0 above threshold + tol/2, a cumulative Gaussian between. The probabilities are summed per grain and variant into job.votes, a table whose rows are job.grains, the best variant first, which calcParentFromVote reads.

With reconsiderAll every measured child grain votes afresh, from its own orientation, for the variant that fits its parent neighbours: the growth step of a reconstruction, which takes back an earlier wrong decision. It needs the grains as measured, before mergeSimilar or after revert.

Input

`job`	parentGrainReconstructor, with job.p2c set
`ind`	with reconsiderAll: the positions of the prior grains to vote for; the table of their votes is returned and job.votes left as it was

Keywords

keyword	default	description
`p2c`	`False`	only the parent to child boundaries vote
`c2c`	`False`	only the child to child boundaries vote
`reconsiderAll`	`False`	every measured child grain votes for the variant that fits its parent neighbours, the decided ones too
`numFit`	`2`	the number of best fitting variants every boundary votes for
`threshold`	`None`	the misfit angle at which the probability is one half, by default 2 degree or minFit when smaller
`tol`	`None`	the width of the angles over which the probability falls from 1 to 0, by default the threshold (MATLAB’s tolerance)
`minFit`	`inf`	a boundary votes only when its best fit is below this angle
`maxFit`	`-inf`	a boundary votes only when its second best fit is above this angle
`bestFit`	`False`	the vote of a grain is the best fit per variant, an angle, instead of a probability
`count`	`False`	the vote of a grain is the number of fits per variant below the threshold
`curvatureFactor`	`None`	with reconsiderAll: weigh a boundary by 1 plus this factor times its normalised curvature, so that curved boundaries count more

Output

votes with ind: voteTable of the votes of those grains

Used on

GrainGraphBasedReconstruction, MaParentGrainReconstruction, TriplePointBasedReconstruction

MATLAB’s parentGrainReconstructor.calcGBVotes

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.calcGBVotes_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.calcGBVotes