the variants of a parent to child orientation relationship, and the child or parent orientations they give

Syntax

p2cVariants = p2c.variants()

The child variants.

p2pVariants = p2c.variants(parent=True)

The parent variants.

oriChild = p2c.variants(oriParent)

Every child variant of every parent.

oriChild = p2c.variants(oriParent, variantId)

One per parent, chosen by its id.

oriParent = p2c.variants(oriChild)

Every parent of every child.

oriParent = p2c.variants(oriChild, variantId)

One per child, chosen by its id.

odfChild = p2c.variants(odfParent)

The child texture.

Description

The child variants are the distinct p2c * r over the rotations r of the parent group modulo the child group, the parent variants the distinct r * p2c over the child group modulo the parent group. They are numbered as MTEX numbers them, which is what a variant id means; the ids count from 1.

The second argument decides what comes back:

none: the variants themselves, a list.
parent orientations: the child orientations, those of the parent’s representative in the fundamental region times the inverse child variants, along a new last axis; with ids one per parent.
orientations in the child frame: their parent orientations in the parent frame, along a new last axis; with ids one per child.
an SO3Fun of the parents: the child texture.

Input

`p2c`	orientation, the parent to child misorientation, from the parent frame to the child frame
`second`	orientation, the parent orientations, or the child orientations; SO3Fun, a parent texture; or ‘parent’, ‘child’
`ids`	the variant ids, one per orientation, broadcast against them; for a texture an SO3Fun of the parent orientations weighting the parents

Keywords

keyword	default	description
`parent`	`False`	the parent variants instead of the child variants

Output

`p2cVariants`	orientation, the variants, a list
`oriChild`	orientation, oriParent.shape + (numVariants,), or oriParent.shape with ids
`oriParent`	orientation, oriChild.shape + (numVariants,)
`odfChild`	SO3Fun, the child texture

Used on

OrientationRelationshipFit

MATLAB’s orientation.variants

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/orientation.variants_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.

orientation.variants