EBSD.calcGrains edit page

grains reconstruction from 2d EBSD data

Syntax

[grains, ebsd] = calcGrains(ebsd, 'angle', 10*degree, 'minPixel', 2, 'alpha', 3.7)
% reconstruction low and high angle grain boundaries
lagb = 2*degree;
hagb = 10*degree;
grains = calcGrains(ebsd,'angle',[hagb lagb])
% specify phase dependent thresholds
% thresholds follow the same order as ebsd.CSList and should have the same length
grains = calcGrains(ebsd,'angle',{angl_1 angle_2 angle_3})
% Markovian clustering algorithm
p = 1.5;    % inflation power (default = 1.4)
maxIt = 10; % number of iterations (default = 4)
delta = 5*degree % variance of the threshold angle
grains = calcGrains(ebsd,'method','mcl',[p maxIt],'soft',[angle delta])

Input

ebsd EBSD

Output

grains grain2d
ebsd EBSD with additional property grainId

Options

angle misorientation angle that indicates a grain boundary
minPixel minimum number of pixels that form a grain. No indexed grain smaller than this is returned; the pixels of one that would be are marked notIndexed
alpha fill distances into not indexed regions
soft [angle delta] soft threshold instead of a hard one
fmc fast multiscale clustering method
mcl Markovian clustering algorithm
custom use a custom property for grain separation

Flags

verbose report what the criterion did, if it has anything to say - currently only |'fmc'|, which prints its cluster hierarchy
delaunay use a true circumradius-based alpha-complex (exact, not a raster approximation) instead of the default morphological closing to partition the spatial domain - see spatialDecompositionAlpha.m. Useful for large alpha, where the default's disk structuring element gets slow.

References

  • F.Bachmann, R. Hielscher, H. Schaeben, Grain detection from 2d and 3d EBSD data - Specification of the MTEX algorithm: Ultramicroscopy, 111, 1720-1733, 2011
  • C. McMahon, B. Soe, A. Loeb, A. Vemulkar, M. Ferry, L. Bassman, Boundary identification in EBSD data with a generalization of fast multiscale clustering, Ultramicroscopy, 2013, 133:16-25.

See also

GrainReconstruction GrainReconstructionAdvanced GrainReconstructionMCL