Start » Filter Reference » Path » Polygon Features » PolygonMoment

PolygonMoment


Module: FoundationBasic

Computes the selected second-order moment of a polygon in regular and normalized ( divided by polygon area ) variant.

Name Type Description
Input value
inPolygon Path
Input value
inMomentType PolygonMomentType
Input value
inCentral Bool
Output value
outMoment Real
Output value
outNormMoment Real

Description

The operation computes the mathematical features of a polygon called moments. Those are integrals computed as follows:

\[ \begin{aligned} Moment_{2,0}(S) &= \int_{S} p_x^2 \\ Moment_{1,1}(S) &= \int_{S} p_x p_y \\ Moment_{0,2}(S) &= \int_{S} p_y^2 \end{aligned} \]

The integration is conducted over polygon surface, while \( p_x \) and \( p_y \) denote, accordingly, x and y coordinate of a point.

When inCentral parameter is set, the polygon is shifted before computations so that its mass center is at location (0,0).

Note that if the input path is not a valid polygon (i.e. it has at least one self-intersection), the computation may lead to results that are not intuitive.

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 Not supported moment type in PolygonMoment.
DomainError Open path on input in PolygonMoment.

Complexity Level

This filter is available on Advanced Complexity Level.

See Also

  • RegionMoment – Computes selected second-order moment of a region in regular and normalized ( divided by region area ) variant.
  • ImageMoment – Computes the selected moment of an image in regular and normalized (divided by sum of pixel values) variant.