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.
Files of DREAM3D-NX and of DREAM.3D 6 are read, whatever the data containers and their attribute matrices are called. A file without a surface mesh gives the grains of its voxel data, those that calcGrains forms from the feature ids.
Syntax
grains = grain3d.load('filepath/filename.dream3d','interface','dream3d')
grains = loadGrains_Dream3d('filepath/filename.dream3d')grains = grain3d.load('filepath/filename.dream3d','noOrientFaces')Keep the face winding exactly as stored in the file.
Input
| fname | filename |
Options
| noOrientFaces | do not orient the boundary faces after import |
Output
| grain3d | grain3d |
See also
grain3d.load grain3d.orientFaces loadNeperTess loadEBSD_dream3d
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.