Skip to content

thickening_golaythickening_golayThickeningGolayThickeningGolaythickening_golaythickening_golay🔗

Short description🔗

thickening_golaythickening_golayThickeningGolayThickeningGolaythickening_golaythickening_golay — Add the result of a hit-or-miss operation to a region (using a Golay structuring element).

Warning🔗

thickening_golayThickeningGolay is obsolete and is only provided for reasons of backward compatibility.

Signature🔗

thickening_golay( region Region, out region RegionThick, string GolayElement, integer Rotation )thickening_golay( Region : RegionThick : GolayElement, Rotation : )void ThickeningGolay( const HObject& Region, HObject* RegionThick, const HTuple& GolayElement, const HTuple& Rotation )static void HOperatorSet.ThickeningGolay( HObject region, out HObject regionThick, HTuple golayElement, HTuple rotation )def thickening_golay( region: HObject, golay_element: str, rotation: int ) -> HObject

Herror thickening_golay( const Hobject Region, Hobject* RegionThick, const char* GolayElement, const Hlong Rotation )

Herror T_thickening_golay( const Hobject Region, Hobject* RegionThick, const Htuple GolayElement, const Htuple Rotation )

HRegion HRegion::ThickeningGolay( const HString& GolayElement, Hlong Rotation ) const

HRegion HRegion::ThickeningGolay( const char* GolayElement, Hlong Rotation ) const

HRegion HRegion::ThickeningGolay( const wchar_t* GolayElement, Hlong Rotation ) const (Windows only)

HRegion HRegion.ThickeningGolay( string golayElement, int rotation )

Description🔗

thickening_golayThickeningGolay performs a thickening of the input regions using morphological operations and structuring elements from the Golay alphabet. The operator first applies a hit-or-miss-transformation to Regionregionregion (cf.
hit_or_miss_golayHitOrMissGolay), and then adds the detected points to the input region. The following structuring elements are available:

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

The rotation number Rotationrotationrotation determines which rotation of the element should be used. The Golay elements, together with all possible rotations, are described with the operator golay_elementsGolayElements.

Attention🔗

Not all values of Rotationrotationrotation are valid for any Golay element.

Execution information🔗

Execution information
  • Multithreading type: reentrant (runs in parallel with non-exclusive operators).

  • Multithreading scope: global (may be called from any thread).

  • Automatically parallelized on tuple level.

Parameters🔗

Regionregionregion (input_object) region(-array) → objectobjectHObjectHRegionHObjectHobject

Regions to be processed.

RegionThickregionThickregion_thick (output_object) region(-array) → objectobjectHObjectHRegionHObjectHobject *

Result of the thickening operator.

GolayElementgolayElementgolay_element (input_control) string → (string)(string)HTuple (HString)HTuple (string)strHtuple (char*)

Structuring element from the Golay alphabet.

Default: 'h'"h"
List of values: 'c', 'd', 'e', 'f', 'f2', 'h', 'i', 'k', 'l', 'm'"c", "d", "e", "f", "f2", "h", "i", "k", "l", "m"

Rotationrotationrotation (input_control) integer → (integer)(integer)HTuple (Hlong)HTuple (int / long)intHtuple (Hlong)

Rotation of the Golay element. Depending on the element, not all rotations are valid.

Default: 00
List of values: 0, 2, 4, 6, 8, 10, 12, 14, 1, 3, 5, 7, 9, 11, 13, 150, 2, 4, 6, 8, 10, 12, 14, 1, 3, 5, 7, 9, 11, 13, 15

Complexity🔗

Let \(F\) be the area of an input region. Then the runtime complexity for one region is:

\[\begin{eqnarray*} O(6 \cdot \sqrt{F}) \enspace . \end{eqnarray*}\]

Result🔗

thickening_golayThickeningGolay returns 2 (H_MSG_TRUE) if all parameters are correct. The clipping according to the global image size is set via the operator set_system('clip_region',<'true'/'false'>). The behavior in case of empty or no input region can be set via:

  • no region: set_system('no_object_result',<RegionResult>)

  • empty region: set_system('empty_region_result',<RegionResult>)

Otherwise, an exception is raised.

Combinations with other operators🔗

Combinations

Possible successors

reduce_domainReduceDomain, select_shapeSelectShape, area_centerAreaCenter, connectionConnection

Alternatives

thickeningThickening, thickening_seqThickeningSeq

See also

erosion_golayErosionGolay, hit_or_miss_golayHitOrMissGolay

Module🔗

Foundation