按邻近性分组 (GeoAnalytics Desktop)

摘要

可对空间或时空上彼此接近的要素进行分组。

以下是可通过按邻近性分组工作流回答的问题示例：

• 连接哪些道路？
• 在临近距离和时间内出现的犯罪集团位于哪里？
• 是否存在相互重叠的面组？

插图

使用情况

• 输出结果是带有名为 group_id 的新字段的输入副本。 该 group_id 字段表示要素的分组。 具有相同 group_id 值的要素在同一组中。 组号表示特定组中的成员身份，并不表示值。 重复使用工具时，组号可能不连续或相同。 结果将用八组符号表示。 如果结果中的组数超过 8 个，则默认情况下所有组都将使用八种颜色进行符号化。 您可以修改符号系统以通过在 group_id 字段上使用唯一符号进行符号化来显示每个唯一组。

• 该工具支持以下关系组合：

  • 空间关系
  • 空间关系和时态关系
  • 空间关系和属性关系
  • 空间关系、时态关系和属性关系
  当满足所有指定的关系时，系统将对要素进行分组。

• 受支持的空间关系和输入几何将如下表所述：

  输入几何类型	相交	接触	测地线邻近	平面邻近
  点
  折线
  面

  叠加方法	描述
  相交	当某些要素或其中的部分重叠时，则这些要素相交。 这是默认设置。
  接触	如果要素与另一个要素具有相交折点，但两者不重叠，则目标要素与连接要素接触。
  测地线邻近	如果顶点或边在另一个要素的给定测地线距离内，则这两个要素邻近。
  平面邻近	如果顶点或边在另一个要素的给定平面距离内，则这两个要素邻近。

• 要使用空间关系参数的邻近平面选项，必须投影输入图层参数值或将输出坐标系设置为投影坐标系。

• 支持的时间关系和时间类型如下表所述：

  输入时间类型	相交	邻近
  无
  时刻
  间隔

  时间关系方法	描述
  相交	当要素时间的任何部分与另一要素重叠时，要素就会相交。
  邻近	如果要素的时间在另一要素的给定时间距离内，则这两个要素彼此邻近。

• 要使用时间关系，您必须在输入上启用时间。 您可以通过以下操作启用时间：

  • 启用多文件要素连接 (MFC) 输入上的时间。
  • 在地图的图层上启用时间。 您可以选择将启用时间的图层另存为 .lyrx 文件。

• 属性表达式是一种对称运算。 该工具将采用在分组时会与自身进行比较的单个输入图层。 正因为如此，该输入图层在 ArcGIS Arcade 表达式中将同时以 a 和 b 表示，并且所有的表达式都需要同时包含 a 和 b。 例如，要在 Amount 字段具有相同值时对所有记录进行分组，请使用以下表达式：$a["Amount"] == $b["Amount"]。

• 可执行以下一项或多项操作来提高按邻近性分组工具的性能：

  • 设置范围环境，以便仅分析感兴趣的数据。
  • 使用空间关系参数的邻近平面或邻近测地线选项时，请使用较小的空间邻近距离参数值。
  • 使用空间关系参数时，邻近平面比邻近测地线选项快。
  • 使用时间关系参数的邻近选项时，请使用较小的时间邻近距离参数值。
  • 将本地数据用于分析运行的位置。

• 此地理处理工具由 Spark 支持。 分析在您的台式计算机上使用多核并行完成。 有关运行分析的详细信息，请参阅 GeoAnalytics Desktop 工具的注意事项。

• 运行 GeoAnalytics Desktop 工具时，分析在您的台式计算机上完成。 为获得最佳性能，应在台式计算机上提供数据。 如果使用的是托管要素图层，则建议您使用 ArcGIS GeoAnalytics Server。 如果数据不是本地数据，则工具需要更长的运行时间。 要使用 ArcGIS GeoAnalytics Server 执行分析，请参阅 GeoAnalytics Tools。

参数

对话框

标注	说明	数据类型
输入图层	将对点、线或面要素进行分组。	Feature Layer
输出	具有分组要素的输出要素类将由新命名的 group_id 字段表示。	Feature Class
空间关系	指定要素分组所依据的关系类型。 相交—当某些要素或其中的部分重叠时，则将对这些要素进行分组。 这是默认设置。 接触—如果要素与另一个要素具有相交顶点，但两者不重叠，则将对要素进行分组。 平面邻近—如果顶点或边在另一个要素的给定平面距离内，则将对要素进行分组。 测地线邻近—如果顶点或边在另一个要素的给定测地线距离内，则将对要素进行分组。	String
空间邻近距离 (可选)	该距离将用于对邻近要素进行分组。 仅当空间关系参数值为邻近平面或邻近测地线时，使用此参数。	Linear Unit
时态关系 (可选)	指定将用于匹配要素的时间条件。 当将该参数设置为相交或邻近且当空间和时间条件都满足时，要素将被分组。 要支持此功能必须在输入上启用时间。 相交—当要素时间的任何部分与另一要素重叠时，要素将被分组。 这是默认设置。 邻近—如果要素的时间在另一要素的时间范围内，则要素将被分组。 无—时间将不会用于对要素进行分组。	String
时态邻近距离 (可选)	时间距离将用于对邻近要素进行分组。 仅当空间关系参数值为邻近时，使用此参数。	Time Unit
属性关系 (可选)	此 ArcGIS Arcade 表达式将用于对要素进行分组。 例如，当 Amount 字段具有相同的值时，$a["Amount"] == $b["Amount"] 将对要素进行分组。	String

Python

arcpy.gapro.GroupByProximity(input_layer, output, spatial_relationship, {spatial_near_distance}, {temporal_relationship}, {temporal_near_distance}, {attribute_relationship})

名称	说明	数据类型
input_layer	将对点、线或面要素进行分组。	Feature Layer
output	具有分组要素的输出要素类将由新命名的 group_id 字段表示。	Feature Class
spatial_relationship	指定要素分组所依据的关系类型。 INTERSECTS—当某些要素或其中的部分重叠时，则将对这些要素进行分组。 这是默认设置。 TOUCHES—如果要素与另一个要素具有相交顶点，但两者不重叠，则将对要素进行分组。 NEAR_PLANAR—如果顶点或边在另一个要素的给定平面距离内，则将对要素进行分组。 NEAR_GEODESIC—如果顶点或边在另一个要素的给定测地线距离内，则将对要素进行分组。	String
spatial_near_distance (可选)	该距离将用于对邻近要素进行分组。 仅当 spatial_relationship 参数值为 NEAR_PLANAR 或 NEAR_GEODESIC 时，使用此参数。	Linear Unit
temporal_relationship (可选)	指定将用于匹配要素的时间条件。 当将该参数设置为 INTERSECTS 或 NEAR 且当空间和时间条件都满足时，要素将被分组。 要支持此功能必须在输入上启用时间。 INTERSECTS—当要素时间的任何部分与另一要素重叠时，要素将被分组。 这是默认设置。 NEAR—如果要素的时间在另一要素的时间范围内，则要素将被分组。 NONE—时间将不会用于对要素进行分组。	String
temporal_near_distance (可选)	时间距离将用于对邻近要素进行分组。 仅当 temporal_relationship 参数值为 Near 时，使用此参数。	Time Unit
attribute_relationship (可选)	此 ArcGIS Arcade 表达式将用于对要素进行分组。 例如，当 Amount 字段具有相同的值时，$a["Amount"] == $b["Amount"] 将对要素进行分组。	String

代码示例

GroupByProximity 示例（独立脚本）

以下 Python 窗口脚本演示了如何使用 GroupByProximity 函数。

# Name: GroupByProximity.py
# Description: Group roads together that touch
#
# Requirements: An advanced license

# Import system modules
import arcpy

# Set local variables
inFeatures = "C:\myData\cities.gdb\roads"
outname = "groupedRoads"
overlayType = "TOUCHES"

# Run Group By Proximity
result = arcpy.gapro.GroupByProximity(inFeatures, outname, overlayType)

环境

输出坐标系, 范围, 当前工作空间, 并行处理因子

许可信息

• Basic: 否
• Standard: 否
• Advanced: 是