A method of EBSD3.

the traces of subregions of a map or of sets of grains, the direction their lamellae run along; MATLAB’s calcTraces

Syntax

traces, rel, cSize = calcTraces(ebsd)

One trace of all indexed pixels, by the Radon transform.

traces, rel, cSize = calcTraces(ebsd, ebsd.phaseId, 'Fourier', minClusterSize=50)

A trace per phase, Fourier based.

traces, rel, cSize = calcTraces(grains, grains.phaseId)

A trace per phase from the characteristic shape.

traces, rel, cSize = calcTraces(grains, grains.phaseId, 'calliper')

The shortest calliper of the shape instead.

Description

A cluster is the set of pixels, or grains, with one value of every column of clusterId, as MATLAB’s clusterId = [grainId, variantId]; ids of zero or NaN belong to no cluster. By default all indexed pixels, or all grains, form one cluster. The outputs have the shape of the largest id of every column. A cluster of minClusterSize pixels or fewer (default 100) keeps a NaN trace and a reliability of zero.

On a map, measured on a lattice, the method is:

‘Radon’, the default: perpendicular to the projection of the cluster with the most energy at high frequencies
‘Fourier’: the axis of the smaller second moment of the cluster image’s Fourier transform

On grains it is:

‘shape’, the default: the principal axis of the characteristic shape of the boundaries
‘calliper’: the direction across the shortest calliper of that shape
‘hist’: the maximum of the length weighted density of the segment directions

The method is a positional string or method=, in any case. A cluster filling a rectangle has no direction: ‘Fourier’ then gives NaN, ‘Radon’ a side of the rectangle with high reliability, as MATLAB’s.

Input

`x`	EBSD on a lattice, or grain2d

Keywords

keyword	default	description
`clusterId`	`None`	one or more columns of ids, a row per pixel or grain, naming the cluster of each; by default one cluster

Output

`traces`	vector3d, antipodal directions in the plane of the map, one per cluster
`rel`	the reliability, how much the winning direction stands out, zero for none
`cSize`	the size of every cluster, pixels on a map, summed numPixel of the grains

References

Determination of child phase habit planes from two-dimensional reconstructed parent phase orientation maps, arXiv 2201.02103 (2022)

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/EBSD3.calcTraces_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.

EBSD3.calcTraces