A method of grain2d.

the caliper, the Feret diameter, of every outline: its width across a direction, or the longest or the shortest width as a framed axis of that length; MATLAB’s grain2d.caliper

Syntax

cV = grains.caliper()

The longest, norm(cV) its length.

cV = grains.caliper('shortest')

The narrowest, or ‘longest’, ‘shortestPerp’.

c = grains.caliper(vector3d.X)

The width across a direction.

c = caliper(grains, [0, 30*degree])

The widths across angles to the x axis.

Description

The width across a direction is the extent of the convex hull projected onto it. ‘longest’ is the diameter of the outline and ‘shortest’ its narrowest width, each the vector3d along which it is measured with that length. ‘shortestPerp’ is the width measured along the direction perpendicular to the shortest one, the direction an outline with flat faces is aligned along. A list of directions or angles gives a width per outline and direction.

Input

grains grain2d, or any set of outlines

Keywords

keyword	default	description
`arg`	`None`	‘longest’ (by default), ‘shortest’ or ‘shortestPerp’, or a direction, an angle to the x axis of the map or a list of them

Output

`cV`	vector3d, one per outline, norm(cV) the length
`c`	array of the widths, (n,) or (n, k) for k directions

Used on

ProjectionBasedParameters

MATLAB’s grain2d.caliper

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/grain2d.caliper_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.

grain2d.caliper