spatial_relationT_spatial_relationSpatialRelationspatial_relationSpatialRelationSpatialRelation (Operator)

Name

spatial_relationT_spatial_relationSpatialRelationspatial_relationSpatialRelationSpatialRelation — Pose relation of regions with regard to the coordinate axes.

Signature

Description

The operator spatial_relationspatial_relationSpatialRelationspatial_relationSpatialRelationSpatialRelation selects regions located by PercentPercentPercentPercentPercentpercent percent “left”, “right”, “above” or “below” other regions. Regions1Regions1Regions1Regions1Regions1regions1 and Regions2Regions2Regions2Regions2Regions2regions2 contain the regions to be compared. Regions1Regions1Regions1Regions1Regions1regions1 can have three states:

• Regions1Regions1Regions1Regions1Regions1regions1 is empty:
  In this case all regions in Regions2Regions2Regions2Regions2Regions2regions2 are permutatively checked for neighborhood.

• Regions1Regions1Regions1Regions1Regions1regions1 consists of one region:
  The regions of Regions1Regions1Regions1Regions1Regions1regions1 are compared to all regions in Regions2Regions2Regions2Regions2Regions2regions2.

• Regions1Regions1Regions1Regions1Regions1regions1 consists of the same number of regions as Regions2Regions2Regions2Regions2Regions2regions2:
  Regions1Regions1Regions1Regions1Regions1regions1 and Regions2Regions2Regions2Regions2Regions2regions2 are checked for a neighboring relation.

The percentage PercentPercentPercentPercentPercentpercent is interpreted in such a way that the area of the second region has to be located really left/right or above/below the region margins of the first region by at least PercentPercentPercentPercentPercentpercent percent. The indices of the regions that fulfill at least one of these conditions are then located at the n-th position in the output parameters RegionIndex1RegionIndex1RegionIndex1RegionIndex1RegionIndex1regionIndex1 and RegionIndex2RegionIndex2RegionIndex2RegionIndex2RegionIndex2regionIndex2. Additionally the output parameters Relation1Relation1Relation1Relation1Relation1relation1 and Relation2Relation2Relation2Relation2Relation2relation2 contain at the n-th position the type of relation of the region pair (RegionIndex1RegionIndex1RegionIndex1RegionIndex1RegionIndex1regionIndex1[n], RegionIndex2RegionIndex2RegionIndex2RegionIndex2RegionIndex2regionIndex2[n]), i.e., region with index RegionIndex2RegionIndex2RegionIndex2RegionIndex2RegionIndex2regionIndex2[n] has the relation Relation1Relation1Relation1Relation1Relation1relation1[n] and Relation2Relation2Relation2Relation2Relation2relation2[n] with region with index RegionIndex1RegionIndex1RegionIndex1RegionIndex1RegionIndex1regionIndex1[n].

Possible values for Relation1Relation1Relation1Relation1Relation1relation1 and Relation2Relation2Relation2Relation2Relation2relation2 are:

Relation1:

'left', 'right' or ”

Relation2:

'above', 'below' or ”

In RegionIndex1RegionIndex1RegionIndex1RegionIndex1RegionIndex1regionIndex1 and RegionIndex2RegionIndex2RegionIndex2RegionIndex2RegionIndex2regionIndex2 the indices of the regions in the tuples of the input regions (Regions1Regions1Regions1Regions1Regions1regions1 or Regions2Regions2Regions2Regions2Regions2regions2), respectively, are entered as image identifiers. Access to chosen regions via the index can be obtained by the operator copy_objcopy_objCopyObjcopy_objCopyObjCopyObj.

Parallelization

• Multithreading type: reentrant (runs in parallel with non-exclusive operators).
• Multithreading scope: global (may be called from any thread).
• Processed without parallelization.

Parameters

Result

The operator spatial_relationspatial_relationSpatialRelationspatial_relationSpatialRelationSpatialRelation returns the value 2 (H_MSG_TRUE) if Regions2Regions2Regions2Regions2Regions2regions2 is not empty and PercentPercentPercentPercentPercentpercent is correctly choosen. The behavior in case of empty parameter Regions2Regions2Regions2Regions2Regions2regions2 (no input regions available) is set via the operator set_system('no_object_result',<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("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>)set_system("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)set_system("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>). If necessary an exception is raised.

Possible Predecessors

thresholdthresholdThresholdthresholdThresholdThreshold, regiongrowingregiongrowingRegiongrowingregiongrowingRegiongrowingRegiongrowing, connectionconnectionConnectionconnectionConnectionConnection

Alternatives

area_centerarea_centerAreaCenterarea_centerAreaCenterAreaCenter, intersectionintersectionIntersectionintersectionIntersectionIntersection

See also

select_region_spatialselect_region_spatialSelectRegionSpatialselect_region_spatialSelectRegionSpatialSelectRegionSpatial, find_neighborsfind_neighborsFindNeighborsfind_neighborsFindNeighborsFindNeighbors, copy_objcopy_objCopyObjcopy_objCopyObjCopyObj, obj_to_integerobj_to_integerObjToIntegerobj_to_integerObjToIntegerObjToInteger

Module

Foundation