the variant graph of a parent grain reconstruction, job.graph; MATLAB’s calcVariantGraph of parentGrainReconstructor

Syntax

job.calcVariantGraph()

The default probabilities.

job.calcVariantGraph(threshold=3.5*degree, tol=1.5*degree) # another misfit at probability 1/2

job.calcVariantGraph(mergeSimilar=True)

Similar variants as one node.

job.calcVariantGraph(c2c=True)

The child to child boundaries only.

Description

The graph has a node per child grain and parent variant and one per parent grain. An edge joins two nodes of neighbouring grains where they agree, weighted by the probability of the agreement: a cumulative Gaussian of the misfit with the mean threshold and the spread tol.

Three kinds of boundaries give edges, all three unless some are asked for:

c2c: two child grains, over every pair of their variants.
p2c: a parent and a child grain, over the variants of the child that fit the parent.
p2p: two parent grains, by their orientations.

When the job holds votes, every grain is restricted to its best variant. The job is changed in place; clusterVariantGraph clusters the graph.

Input

job parentGrainReconstructor with its orientation relationship job.p2c

Keywords

keyword	default	description
`threshold`	`2*degree`	the misfit at which the probability is 1/2
`tol`	`1.5*degree`	the range about threshold over which the probability goes from 1 to 0
`p2c`	`False`	the parent to child boundaries
`p2p`	`False`	the parent to parent boundaries
`c2c`	`False`	the child to child boundaries
`mergeSimilar`	`False`	join the variants within 8 degrees of one another into one node
`diagonal`	`True`	put every node on the diagonal of the graph, the loops MCL needs

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.calcVariantGraph

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.calcVariantGraph_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.calcVariantGraph