find_neighborsT_find_neighborsFindNeighborsFindNeighborsfind_neighbors（算子）

名称

find_neighborsT_find_neighborsFindNeighborsFindNeighborsfind_neighbors — 搜索直接邻居。

签名

描述

算子 find_neighborsfind_neighborsFindNeighborsFindNeighborsFindNeighborsfind_neighbors determines neighboring regions with Regions1Regions1Regions1Regions1regions1regions_1 and Regions2Regions2Regions2Regions2regions2regions_2 containing the regions to be examined. 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:
  Here all regions at the n-th position in Regions1Regions1Regions1Regions1regions1regions_1 and Regions2Regions2Regions2Regions2regions2regions_2 are checked for the neighboring relation.

算子 find_neighborsfind_neighborsFindNeighborsFindNeighborsFindNeighborsfind_neighbors uses the chessboard distance between neighboring regions. It can be specified by the parameter MaxDistanceMaxDistanceMaxDistanceMaxDistancemaxDistancemax_distance. Neighboring regions are located at the n-th position in RegionIndex1RegionIndex1RegionIndex1RegionIndex1regionIndex1region_index_1 and RegionIndex2RegionIndex2RegionIndex2RegionIndex2regionIndex2region_index_2, i.e., the region with index RegionIndex1RegionIndex1RegionIndex1RegionIndex1regionIndex1region_index_1[n] from Regions1Regions1Regions1Regions1regions1regions_1 is the neighbor of the region with index RegionIndex2RegionIndex2RegionIndex2RegionIndex2regionIndex2region_index_2[n] from Regions2Regions2Regions2Regions2regions2regions_2。

注意

Covered regions are not found!

执行信息

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

参数

结果

算子 find_neighborsfind_neighborsFindNeighborsFindNeighborsFindNeighborsfind_neighbors 在输入不为空时返回值 2 ( H_MSG_TRUE )。当输入为空（无可用输入区域）时，可设置行为通过算子 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

另见

spatial_relationspatial_relationSpatialRelationSpatialRelationSpatialRelationspatial_relation, select_region_spatialselect_region_spatialSelectRegionSpatialSelectRegionSpatialSelectRegionSpatialselect_region_spatial, expand_regionexpand_regionExpandRegionExpandRegionExpandRegionexpand_region, distance_transformdistance_transformDistanceTransformDistanceTransformDistanceTransformdistance_transform, interjacentinterjacentInterjacentInterjacentInterjacentinterjacent, boundaryboundaryBoundaryBoundaryBoundaryboundary

模块

基础