MTEX - A MATLAB Toolbox for Quantitative Texture Analysis

Grains (The Class GrainSet)

class representing grains of spatially indexed individual orientations
Class Description
A grain based analysis starts with constructing grains. We define a grain as a region, in
which the misorientation of neighbored measurements is less than a given threshold.
mtexdata forsterite
grains = calcGrains(ebsd, 'angle',12.5*degree)
I'm removing all not indexed phases. The option "keepNotIndexed" keeps them.

grains = Grain2d-Set
comment: /home/hielscher/svn/mtex-default/data/EBSD/forsterite.ct
grain properties: boundaryEdgeOrder
EBSD properties: bands, bc, bs, error, mad, x, y, mis2mean
Phase Grains Orientations Mineral Symmetry Crystal reference frame
0 0 0 notIndexed
1 1116 152345 Forsterite mmm
2 515 26058 Enstatite mmm
3 1498 9064 Diopside 2/m X||a*, Y||b, Z||c

plot(grains)
A GrainSet holds topological information about a spatially indexed individual orientations.
These are:
an adjacency matrix storing which measurements
are neighboured
an incidence matrix storing which measurement is
incident to a grain

an adjacency matrix storing which grains are
neighboured
furthermore, there are two incidence matrices
marking which faces of a measurement
belongs to the grain boundary.
marking which face of a measurement
belongs to the grain boundary inside of a grain, i.e. is a subboundary.
With this five sparse matrices, almost every task in grain based analysis can be processed
reasonably.
For some geometrical reasons, we distinguish between Grain2d and Grain3d.
The figure below illustrates basic interactions between a GrainSet , its EBSD data and the
purpose towards Orientation Analysis. Further details are explained under the topic Grain
Analysis .

Complete Function list
GrainSet construct
all
test if all grains of a GrainSet are in use by
the object
and
logical and to compare a GrainSet with some
other set, in particular
any test if grains are in the GrainSet
calcBoundaryMisorientation calculate misorientation at grain boundaries
calcGOS
intergranular average misorientation angle per
orientation
calcKAM
intergranular average misorientation angle per
orientation
calcKernel
compute an optimal kernel function for ODF
estimation (with mean orientation of
calcMisorientation
calculate misorientation for any two
neighbored measurments of the same
diameter
of a grain (longest distance between any two
vertices of a grain
display standard output
end overloaded end function
findByLocation select a grain by spatial coordinates
findByOrientation select grains by orientation
get return property of a GrainSet
grainSize returns the number of measurments per grain
horzcat
concatenation of grains from the same
GrainSet
joinCount
returns the a joinscount between neighbour
coloring
logical convert GrainSet into a logical array
merge grains with special boundary
neighbors returns the number of neighboring grains
not overloads not operator
numel number of grains
or
logical or to compare a GrainSet with some
other set, in particular
plot bypasses to the Grain plotting routines
plotBoundary colorize grain boundaries
plotspatial
overloads EBSD data of selected grains to
the EBSD/plotspatial routine
principalcomponents
returns the principalcomponents of grain
polygon, without Holes
size overloads size
smooth constraint laplacian smoothing of grains
specialBoundary
classifies the misorientation present on grain
boundaries
subsref access subsets of a GrainSet
vertcat
concatenation of grains from the same
GrainSet
MTEX 3.5.0