grain3d.orientFaces edit page

set up grain.I_GF such that +/- 1 indicates outgoing/ingoing normals

Description

Some file formats, e.g. Dream3d, do not store the boundary faces of a grain with a consistent winding, i.e., the normals computed from the vertex order point randomly into or out of the grain. This function determines for every face and every adjacent grain whether the stored normal points out of that grain (+1) or into it (-1) and stores the result in grains.I_GF. It also updates grains.boundary.grainId such that the face normal always points from the first to the second grain.

The faces themselves are not modified. Non manifold edges, i.e. edges where the surface of a grain pinches itself, are ignored - the resulting surface patches are oriented independently of each other.

Syntax

grains = grains.orientFaces

Input

grains grain3d

Output

grains grain3d

See also

grain3d.volume grain3Boundary.grain3Boundary

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/grain3d.orientFaces.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.