Start » Filter Reference » Region » Region Features » RegionMassCenter

RegionMassCenter


Module: FoundationLite

Computes a point with coordinates equal to the average coordinates of the region's pixels.

Name Type Description
Input value
inRegion Region Input region
Output value
outMassCenter Point2D
Output value
outArea Integer

Description

The operation computes the average of all pixel locations contained in a region. Note that the result is a Point2D, not a Location as its coordinates may be not-integer.

Hints

  • If the input region is not guaranteed to be non-empty, precede this filter with SkipEmptyRegion.

Examples

Description of usage of this filter can be found in examples and tutorial: Calibration World Coordinates On Original Images, Capsules, Inset Distances, Molybdenum Foil, Washers.

The resulting outMassCenter point drawn onto the sample region.

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 Input region is empty in RegionMassCenter.

Complexity Level

This filter is available on Basic Complexity Level.

Filter Group

This filter is member of RegionMassCenter filter group.

See Also