the 3D grains read from a file, the surface mesh of a DREAM.3D file or the polyhedra of a 3D Neper tessellation; MATLAB’s grain3d.load and loadGrains_Dream3d

Syntax

grains = loadGrains3d('grains.dream3d')

The surface mesh of DREAM.3D.

grains = loadGrains3d('grains.dream3d', orientFaces=False)

The faces as stored.

grains = loadGrains3d('grains.tess', CS=cs)

A Neper tessellation.

Description

The format is told by the extension:

  • ‘.dream3d’: the surface mesh of DREAM.3D 6 or DREAM3D-NX, whatever its data containers are called. A file without a surface mesh gives the grains calcGrains forms from the feature ids of its voxels.
  • ‘.tess’: the polyhedra of a 3D Neper tessellation with the orientations it holds. A 2D tessellation is refused; read it with loadNeperTess.

DREAM.3D stores the faces with random winding, so their normals point into or out of the grain at random. The faces are therefore oriented on import by grain3d.orientFaces, which makes the face normals, the grain volumes and boundary.grainId meaningful; orientFaces=False keeps the winding of the file. grain3d.load is the same function.

Input

fname the file name, .dream3d or .tess

Keywords

keyword default description
interface None the format, ‘dream3d’ or ‘neper’; by default told by the extension
CS None a crystalFrame or a phaseList replacing the phases of the file; for a Neper file by default the crystal system it states
orientFaces True orient the faces of a DREAM.3D mesh consistently, MATLAB’s ‘noOrientFaces’ when False

Output

grains grain3d

See also

grain3d.orientFaces, loadNeperTess, loadEBSD3, calcGrains, Dream3dGrains, NeperInterface

MATLAB’s loadGrains_Dream3d

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