fitting

Herror ::fitting ( Hobject Region, Hobject StructElements, Hobject *RegionFitted ) HRegion HRegion::Fitting ( const HRegionArray &StructElements ) const HRegionArray HRegionArray::Fitting ( const HRegionArray &StructElements ) const

Perform a closing after an opening with multiple structuring elements.

::fitting performs an ::opening and a ::closing successively on the input regions. The eight structuring elements normally used for this operation can be generated with the operator ::gen_struct_elements. However, other user-defined structuring elements can also be used. Let R be the input region(s) and let M(i) denote the structuring elements. Furthermore, let P be the result of the opening and Q be the final result. Then the operator can be formalized as follows:

           n
          |  |
      P = |  | R o M      (opening)
          \__/      i
          i=1

           n_
          /  \
      Q = |  | P * M      (closing)
          |  |      i
          i=1

Regions larger than the structuring elements are preserved, while small gaps are closed.

Parameters

`Region` (input_object)	region(-array) `->` Hobject: HRegion(Array)
Regions to be processed.

`StructElements` (input_object)	region(-array) `->` Hobject: HRegion(Array)
Structuring elements.

`RegionFitted` (output_object)	region(-array) `->` Hobject : HRegion(Array)*
Fitted regions.

Result

::fitting returns H_MSG_TRUE if all parameters are correct. The behavior in case of empty or no input region can be set via:

  a) no region:    set_system('no_object_result',<RegionResult>)
  b) empty region: set_system('empty_region_result',<RegionResult>)

Otherwise, an exception is raised.

Possible Predecessors

::gen_struct_elements, ::gen_region_points

Possible Successors

::reduce_domain, ::select_shape, ::area_center, ::connection

Alternatives

::opening, ::closing, ::connection, ::select_shape

Module

Morphology