A method of neper.

a microstructure of twinned grains: Neper’s grains cut into lamellae, every second lamella in twin orientation; MATLAB’s neper.simulateTwinGrains

Syntax

grains = nep.simulateTwinGrains(100, mori, odf, bndA)

100 twinned grains.

grains = nep.simulateTwinGrains(100, mori, odf, bndA, width=0.05)

Lamellae of width 0.05.

grains = nep.simulateTwinGrains(100, mori, odf, bndA, rng=np.random.default_rng(0))

The same random turns every run.

Description

The orientations of the host grains are sampled from odf, and every host gets a lamella normal, a crystal direction sampled from bndA turned by the host’s orientation. Neper tessellates the domain into numGrains cells and cuts every cell into lamellae of the given width normal to its direction. The lamellae take their host’s orientation and every second one the twin orientation, the host’s orientation times mori; every lamella is turned at random by up to 2 degree.

MATLAB calls it on the class, neper.simulateTwinGrains; here it is a method of the interface neper.init() returns, and MATLAB’s flag ‘silent’ is verbose=False, the default.

Input

`numGrains`	the number of host grains
`mori`	orientation, the twin misorientation from the host to the twin
`odf`	SO3Fun, the distribution of the host orientations
`bndA`	S2Fun on crystal directions, the distribution of the lamella normals

Keywords

keyword	default	description
`width`	`None`	the width of the lamellae, by default a quarter of the edge of a cube of the mean grain volume of a cube(…) geometry
`verbose`	`False`	print Neper’s output
`aspectRatio`	`None`	three lengths, the aspect ratio of the host grains along x, y and z
`rng`	`None`	numpy.random.Generator of the random turns of the lamellae

Output

grains grain3d, every lamella one grain, with meanOrientation

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/neper.simulateTwinGrains_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.

neper.simulateTwinGrains

Syntax

Description

Input

Keywords

Output

See also