hit_or_miss

Herror ::hit_or_miss_seq ( Hobject Region, Hobject *RegionHitMiss, const HTuple &GolayElement ) HRegion HRegion::HitOrMissSeq ( const HTuple &GolayElement ) const HRegionArray HRegionArray::HitOrMissSeq ( const HTuple &GolayElement ) const

Hit-or-miss operation for regions using the Golay alphabet (sequential).

::hit_or_miss_golay performs the hit-or-miss-transformation for the input regions Region using all rotations of a structuring element from the Golay alphabet. The result of the operator is the union of all intermediate results of the respective rotations. The following structuring elements are available:

'l', 'm', 'd', 'c', 'e', 'i', 'f', 'f2', 'h', 'k'.

The Golay elements, together with all possible rotations, are described with the operator ::golay_elements.

Parameters

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

`RegionHitMiss` (output_object)	region(-array) `->` Hobject : HRegion(Array)*
Result of the hit-or-miss operation.

`GolayElement` (input_control)	string `->` HTuple.char *
Structuring element from the Golay alphabet.
Default value: 'h'
List of values: 'l', 'm', 'd', 'c', 'e', 'i', 'f', 'f2', 'h', 'k'

Complexity

Let F be the area of an input region, and R be the number of rotations. Then the runtime complexity for one region is:

      O(R * 6 * sqrt(F)) .

Result

::hit_or_miss_seq 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

::threshold, ::regiongrowing, ::connection, ::union1, ::watersheds, ::class_ndim_norm

Possible Successors

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

Alternatives

::hit_or_miss_golay, ::hit_or_miss

See also

::thinning_seq, ::thickening_seq

Module

Morphology