Start » Filter Reference » Path » Path Features » PathDiameter

PathDiameter


Module: FoundationLite

Finds the longest segment connecting two characteristic points of a path.

Name Type Description
Input value
inPath Path Input path
Output value
outDiameter Segment2D
Output value
outDiameterLength Real

Description

The operation finds the most distant pair of points within a path and returns the distance between them (outDiameterLength) and the segment representing the diameter (outDiameter). If there is more than one pair of maximal distance, the returned segment will correspond to one of them. The orientation of the resulting outDiameter is always between 0 and 180 degrees.

Examples

The resulting outDiameterLength = 280.0921, outDiameter segment was drawn onto the sample path.

Errors

This filter can throw an exception to report error. Read how to deal with errors in Error Handling.

List of possible exceptions:

Error type Description
DomainError Empty path on input in PathDiameter.

Complexity Level

This filter is available on Basic Complexity Level.

See Also

  • RegionDiameter – Computes the longest segment connecting two pixels contained in region and its length.