the state of a parent grain reconstruction: the map and the grains it starts from, the orientation relationship and the grains after every step taken; MATLAB’s parentGrainReconstructor

Syntax

job = parentGrainReconstructor(ebsd, grains)

The parent and child phases guessed.

job = parentGrainReconstructor(ebsd, grains, orientation.KurdjumovSachs(csParent, csChild))

With an initial orientation relationship.

job = parentGrainReconstructor(ebsd, grains, p2c, useBoundaryOrientations=True)

Votes from the orientations along the boundaries.

job = parentGrainReconstructor(ebsd)

The grains segmented at 3 degree.

Description

The job keeps the map and the grains as given, ebsdPrior and grainsPrior, the grains at the current stage, grains, with parentGrains and childGrains, and for every prior grain the id of the current grain it went into, mergeId. The steps of a reconstruction are its methods: calcParent2Child refines the orientation relationship p2c, calcGBVotes, calcTPVotes or calcGraph with clusterVariantGraph collect votes, calcParentFromVote and calcParentFromGraph turn child grains into parent grains, mergeSimilar and mergeInclusions merge them, and calcParentEBSD gives the reconstructed map, with variantId and packetId.

The phases are guessed from the map: the most frequent indexed phase is the child and the rarest the parent, which job.csParent and job.csChild correct, or setting job.p2c, whose frames then name both. The parent frame is added to the phase lists of the job’s copies when the map carries only the child. The map must carry the grain ids of grains, which calcGrains writes into it.

Input

`ebsd`	EBSD, the map of the measured, mostly child, phase, with the grain ids of grains
`grains`	grain2d, the child grains of the map; when not given the map is segmented at 3 degree, on a copy
`p2c`	orientation, the initial guess of the parent to child orientation relationship (MATLAB’s p2c0)

Keywords

keyword	default	description
`useBoundaryOrientations`	`False`	a pair of grains votes with the mean orientations of their pixels along the boundary they share rather than with the grain means
`reportFit`	`True`	show the quantiles of the misfit of the boundaries to p2c when the job is displayed

Output

job parentGrainReconstructor

References

R. Hielscher, T. Nyyssönen, F. Niessen, A. A. Gazder, The variant graph approach to improved parent grain reconstruction, Materialia 22 (2022) 101399
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, OrientationRelationshipFit, TiBetaReconstruction, TriplePointBasedReconstruction

MATLAB’s parentGrainReconstructor.parentGrainReconstructor

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.parentGrainReconstructor_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.parentGrainReconstructor