fitting

fitting ( Region, StructElements : RegionFitted : : )

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) `->` object
Regions to be processed.

`StructElements` (input_object)	region(-array) `->` object
Structuring elements.

`RegionFitted` (output_object)	region(-array) `->` object
Fitted regions.

Result

fitting returns 2 (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.

Parallelization Information

fitting is reentrant and processed without parallelization.

Possible Predecessors

gen_struct_elements, gen_region_points

Possible Successors

reduce_domain, select_shape, area_center, connection

Alternatives

opening, closing, connection, select_shape

Module

Foundation