the variant graph clustered by the MCL algorithm generalised to the variants of a grain, the votes for the parent orientations; MATLAB’s clusterVariantGraph of parentGrainReconstructor

Syntax

job.clusterVariantGraph()

Job.votes from the variant graph.

job.clusterVariantGraph(includeSimilar=True)

Similar variants share their score.

job.clusterVariantGraph(threshold=3*degree)

The graph built first with these options.

job.calcParentFromVote(minProb=0.5)

The parents from the votes.

Description

The variant graph is built by calcVariantGraph first when the job has none, with the keywords left over. Then numIter steps of MCL: the expansion, the inflation by inflationPower and the pruning below cutOff, the rows of the nodes of one grain normalised together. The score of every node of a child grain whose cluster has at least minCluster members becomes its vote, job.votes, the variants of every grain ordered by it. The graph is removed unless keepGraph. The job is changed in place.

Input

job parentGrainReconstructor with its orientation relationship job.p2c

Keywords

keyword	default	description
`inflationPower`	`1.05`	the inflation power of MCL
`numIter`	`10`	the number of iterations
`cutOff`	`0.0001`	the entries below it are pruned in every iteration
`minCluster`	`4`	the least size of a cluster whose scores become votes
`includeSimilar`	`False`	a variant takes 0.9 of the score of the variants within 5 degrees
`mergeSimilar`	`False`	a variant takes the whole score of the variants within 5 degrees
`pseudoDiagonal`	`True`	keep the links between the variants of one child grain
`sym`	`False`	make the graph symmetric in every iteration, the geometric mean of both directions
`keepGraph`	`False`	keep the clustered graph in job.graph

References

R. Hielscher, T. Nyyssönen, F. Niessen, A.A. Gazder, The variant graph approach to improved parent grain reconstruction, Materialia 22 (2022) 101399

Used on

MaParentGrainReconstruction, TiBetaReconstruction

MATLAB’s parentGrainReconstructor.clusterVariantGraph

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.clusterVariantGraph_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.clusterVariantGraph