Back to Adaptive Vision Studio website

You are here: Start » Filter Reference » Region Relations » GetMinimumRegion

GetMinimumRegion


Returns the region from the input array that corresponds to the smallest computed feature value.

Name Type Description
inRegions RegionArray Input regions
inFeature RegionFeature Region feature value to be computed
outRegion Region Output region
outValue Real Computed feature value of the output region
outIndex Integer

Applications

Use this filter when to you have an array of regions and you want to select one of them that best matches some criterion.

Description

The filter computes the selected feature value for every input region and returns the one for which value is the smallest.

Examples

Description of usage of this filter can be found in examples and tutorial: Sorting Blobs.

GetMinimumRegion performed with Area as the selected region feature.

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 region array on input in GetMinimumRegion.

Complexity Level

This filter is available on Basic Complexity Level.

Filter Group

This filter is member of GetMinimumRegion filter group.

See Also

  • GetMaximumRegion – Returns the region from the input array that corresponds to the largest computed feature value.
  • SortRegions – Changes the order of regions from the input array accordingly to an ascending/descending sequence of their computed feature values.
  • ClassifyRegions – Splits an array of regions according to the selected feature and range.