A method of grain3d.
the grains of vertices, faces and the incidence of grains and faces; MATLAB’s grain3d constructor
Syntax
grains = grain3d.fromFaces(V, F, I_GF)
The geometry only.
grains = grain3d.fromFaces(V, F, I_GF, ori, CSList, phaseId)
With phases and orientations.
Description
A face lies between the grain whose row of I_GF is +1 for it, the side its normal points away from, and the one whose row is -1; a face with one grain only lies on the outer surface. The misorientation of a face follows from the mean rotations of its two grains. Every grain is of phase 1 when CSList has an indexed phase, else not indexed; the voxels are unknown.
Input
V |
(n, 3) array or vector3d, the vertices |
F |
(m, 3) array of triangles, or a list of polygons, indices into V |
I_GF |
(grains x faces) array or sparse matrix of +1, -1 and 0 |
ori |
rotation or orientation, or (grains, 4) quaternions, the mean rotation of every grain |
CSList |
phaseList, or a list of crystalFrame with ‘notIndexed’ first |
phaseId |
int array, the phase of every grain as the index into CSList |
Keywords
| keyword | default | description |
|---|---|---|
frame |
None |
specimenFrame of the vertices |
Output
grains |
grain3d |
See also
grain3d.load, calcGrains, grain3d.orientFaces, Grains3D
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/grain3d.fromFaces_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.