select_region_spatialSelectRegionSpatialSelectRegionSpatialselect_region_spatialT_select_region_spatial

HALCON ScriptCpp++.NETPythonC

Short description

select_region_spatialSelectRegionSpatialSelectRegionSpatialselect_region_spatialT_select_region_spatial — Pose relation of regions.

Signature

select_region_spatial( region Regions1, region Regions2, string Direction, out integer RegionIndex1, out integer RegionIndex2 )void SelectRegionSpatial( const HObject& Regions1, const HObject& Regions2, const HTuple& Direction, HTuple* RegionIndex1, HTuple* RegionIndex2 )static void HOperatorSet.SelectRegionSpatial( HObject regions1, HObject regions2, HTuple direction, out HTuple regionIndex1, out HTuple regionIndex2 )def select_region_spatial( regions_1: HObject, regions_2: HObject, direction: str ) -> Tuple[Sequence[int], Sequence[int]]

Herror T_select_region_spatial( const Hobject Regions1, const Hobject Regions2, const Htuple Direction, Htuple* RegionIndex1, Htuple* RegionIndex2 )

HTuple HRegion::SelectRegionSpatial( const HRegion& Regions2, const HString& Direction, HTuple* RegionIndex2 ) const

HTuple HRegion::SelectRegionSpatial( const HRegion& Regions2, const char* Direction, HTuple* RegionIndex2 ) const

HTuple HRegion::SelectRegionSpatial( const HRegion& Regions2, const wchar_t* Direction, HTuple* RegionIndex2 ) const (Windows only)

HTuple HRegion.SelectRegionSpatial( HRegion regions2, string direction, out HTuple regionIndex2 )

Description

The operator select_region_spatialSelectRegionSpatial chooses the regions from Regions2regions2regions_2 which are sufficient for the neighboring relation Directiondirectiondirection. The regions to be examined have to be passed in Regions1regions1regions_1 or
Regions2regions2regions_2, respectively. Regions1regions1regions_1 can have three different states:

• Regions1regions1regions_1 is empty:

  In this case all regions in Regions2regions2regions_2 are permutatively checked for neighborhood.

• Regions1regions1regions_1 consists of one region:

  The regions of Regions1regions1regions_1 are compared to all regions in Regions2regions2regions_2.

• Regions1regions1regions_1 consists of the same number of regions as Regions2regions2regions_2:

  The regions at the n-th position in Regions1regions1regions_1 and Regions2regions2regions_2 are each checked for a neighboring relation.

Possible values for Directiondirectiondirection are:

• 'left'"left": Regions2regions2regions_2 is left of Regions1regions1regions_1

• 'right'"right": Regions2regions2regions_2 is right of Regions1regions1regions_1

• 'above'"above": Regions2regions2regions_2 is above Regions1regions1regions_1

• 'below'"below": Regions2regions2regions_2 is below Regions1regions1regions_1

The operator select_region_spatialSelectRegionSpatial calculates the centers of the regions to be compared and decides according to the angle between the center straight lines and the x axis whether the direction relation is fulfilled. The relation is fulfilled within the area of -45 degree to +45 degree around the coordinate axes. Thus, the direction relation can be understood in such a way that the center of the second region must be located left (or right, above, below) of the center of the first region. The indices of the regions fulfilling the direction relation are located at the n-th position in RegionIndex1regionIndex1region_index_1 and RegionIndex2regionIndex2region_index_2, i.e., the region with the index RegionIndex2regionIndex2region_index_2[n] has the indicated relation with the region with the index RegionIndex1regionIndex1region_index_1[n]. Access to regions via the index can be obtained via the operator copy_objCopyObj.

Execution information

Execution information

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

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

• Processed without parallelization.

Parameters

Regions1regions1regions_1 (input_object) region(-array) → objectHObjectHRegionHObjectHobject

Starting regions

Regions2regions2regions_2 (input_object) region(-array) → objectHObjectHRegionHObjectHobject

Comparative regions

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

Desired neighboring relation.

Default: 'left'"left"
List of values: 'above', 'below', 'left', 'right'"above", "below", "left", "right"

RegionIndex1regionIndex1region_index_1 (output_control) integer-array → (integer)HTuple (Hlong)HTuple (int / long)Sequence[int]Htuple (Hlong)

Indices in the input tuples (Regions1regions1regions_1 or
Regions2regions2regions_2), respectively.

RegionIndex2regionIndex2region_index_2 (output_control) integer-array → (integer)HTuple (Hlong)HTuple (int / long)Sequence[int]Htuple (Hlong)

Indices in the input tuples (Regions1regions1regions_1 or
Regions2regions2regions_2), respectively.

Result

The operator select_region_spatialSelectRegionSpatial returns the value 2 (H_MSG_TRUE) if Regions2regions2regions_2 is not empty. The behavior in case of empty parameter Regions2regions2regions_2 (no input regions available) is set via the operator set_system('no_object_result',<Result>). The behavior in case of empty region (the region is the empty set) is set via set_system('empty_region_result',<Result>). If necessary an exception is raised.

Combinations with other operators

Combinations

Possible predecessors

thresholdThreshold, regiongrowingRegiongrowing, connectionConnection

Alternatives

area_centerAreaCenter, intersectionIntersection

See also

spatial_relationSpatialRelation, find_neighborsFindNeighbors, copy_objCopyObj, obj_to_integerObjToInteger

Module

Foundation