coarsen a list of grain boundary segments
Description
Dissolves every vertex that is not needed, keeping only every n-th one along each chain. Junctions are always kept, so the topology of the boundary network is preserved - which grains touch which, and where, is unchanged. This merges segments rather than dropping them, so the boundary stays connected and its total length is preserved up to the straightening of the removed corners.
A grain that would be left with fewer than three vertices, and so collapse onto a line, is not coarsened at all.
The properties of the merged segments - grainId, ebsdId, misrotation - are inherited from the last segment of each run. They are constant along a chain anyway, apart from misrotation.
Syntax
gB_red = reduce(gB)
gB_red = reduce(gB,n)
gB_red = reduce(gB,n,'protect',vertexIds)Input
| gB | grainBoundary |
| n | keep every n-th vertex (default 2) |
Output
| gB_red | grainBoundary |
Options
| protect | ids of vertices that must survive, on top of the junctions |
See also
grainBoundary.simplify grainBoundary.order grain2d.reduceBoundary EBSD.reduce
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/grainBoundary.reduce.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.