loadGrains_Dream3d edit page

loadGrains_Dream3d is a method to load 3d grain data from dream3d

Description

Dream3d does 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. The faces are therefore oriented on import with orientFaces, so that face normals, grain volumes and boundary.grainId are meaningful right away. Pass the option 'noOrientFaces' to get the raw winding as stored in the file.

Syntax

grains = grain3d.load('filepath/filename.dream3d','interface','dream3d')
grains = loadGrains_Dream3d('filepath/filename.dream3d')
% keep the face winding exactly as stored in the file
grains = grain3d.load('filepath/filename.dream3d','noOrientFaces')

Input

fname filename

Output

grain3d grain3d

Options

noOrientFaces do not orient the boundary faces after import

See also

grain3d.load grain3d.orientFaces loadNeperTess

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/loadGrains_Dream3d.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.