select_region_spatialT_select_region_spatialSelectRegionSpatialSelectRegionSpatialselect_region_spatial (算子)

名称

select_region_spatialT_select_region_spatialSelectRegionSpatialSelectRegionSpatialselect_region_spatial — 区域的姿态关系。

签名

描述

算子 select_region_spatialselect_region_spatialSelectRegionSpatialSelectRegionSpatialSelectRegionSpatialselect_region_spatial chooses the regions from Regions2Regions2Regions2Regions2regions2regions_2 which are sufficient for the neighboring relation DirectionDirectionDirectionDirectiondirectiondirection. The regions to be examined have to be passed in Regions1Regions1Regions1Regions1regions1regions_1 or Regions2Regions2Regions2Regions2regions2regions_2, respectively. Regions1Regions1Regions1Regions1regions1regions_1 can have three different states:

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

• Regions1Regions1Regions1Regions1regions1regions_1 consists of one region:
  The regions of Regions1Regions1Regions1Regions1regions1regions_1 are compared to all regions in Regions2Regions2Regions2Regions2regions2regions_2。

• Regions1Regions1Regions1Regions1regions1regions_1 consists of the same number of regions as Regions2Regions2Regions2Regions2regions2regions_2:
  The regions at the n-th position in Regions1Regions1Regions1Regions1regions1regions_1 and Regions2Regions2Regions2Regions2regions2regions_2 are each checked for a neighboring relation.

Possible values for DirectionDirectionDirectionDirectiondirectiondirection are:

'left'：

Regions2Regions2Regions2Regions2regions2regions_2 is left of Regions1Regions1Regions1Regions1regions1regions_1

'right'：

Regions2Regions2Regions2Regions2regions2regions_2 is right of Regions1Regions1Regions1Regions1regions1regions_1

'above'：

Regions2Regions2Regions2Regions2regions2regions_2 is above Regions1Regions1Regions1Regions1regions1regions_1

'below'：

Regions2Regions2Regions2Regions2regions2regions_2 is below Regions1Regions1Regions1Regions1regions1regions_1

算子 select_region_spatialselect_region_spatialSelectRegionSpatialSelectRegionSpatialSelectRegionSpatialselect_region_spatial 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 RegionIndex1RegionIndex1RegionIndex1RegionIndex1regionIndex1region_index_1 and RegionIndex2RegionIndex2RegionIndex2RegionIndex2regionIndex2region_index_2, i.e., the region with the index RegionIndex2RegionIndex2RegionIndex2RegionIndex2regionIndex2region_index_2[n] has the indicated relation with the region with the index RegionIndex1RegionIndex1RegionIndex1RegionIndex1regionIndex1region_index_1[n]. Access to regions via the index can be obtained via the operator copy_objcopy_objCopyObjCopyObjCopyObjcopy_obj。

执行信息

• 多线程类型：可重入（与非独占算子并行运行）。
• 多线程作用域：全局（可从任何线程调用）。
• 未采用并行化处理。

参数

结果

算子 select_region_spatialselect_region_spatialSelectRegionSpatialSelectRegionSpatialSelectRegionSpatialselect_region_spatial 返回值 2 ( H_MSG_TRUE) if Regions2Regions2Regions2Regions2regions2regions_2 is not empty. The behavior in case of empty parameter Regions2Regions2Regions2Regions2regions2regions_2 (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>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)set_system("no_object_result",<Result>)。空区域（区域是空集）的情况下的可设置行为通过 set_system('empty_region_result',<Result>)set_system("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)set_system("empty_region_result",<Result>)。如有必要，则抛出异常。

可能的前趋

thresholdthresholdThresholdThresholdThresholdthreshold, regiongrowingregiongrowingRegiongrowingRegiongrowingRegiongrowingregiongrowing, connectionconnectionConnectionConnectionConnectionconnection

替代

area_centerarea_centerAreaCenterAreaCenterAreaCenterarea_center, intersectionintersectionIntersectionIntersectionIntersectionintersection

另见

spatial_relationspatial_relationSpatialRelationSpatialRelationSpatialRelationspatial_relation, find_neighborsfind_neighborsFindNeighborsFindNeighborsFindNeighborsfind_neighbors, copy_objcopy_objCopyObjCopyObjCopyObjcopy_obj, obj_to_integerobj_to_integerObjToIntegerObjToIntegerObjToIntegerobj_to_integer

模块

基础