按邻近性分组 (GeoAnalytics Server 工具)

汇总

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

旧版本：

即将在 ArcGIS Enterprise 中弃用 ArcGIS GeoAnalytics Server 扩展模块。 GeoAnalytics Server 的最终版本已随 ArcGIS Enterprise 11.3 一同发布。可通过 ArcGIS Enterprise 11.3 及较早版本获取此地理处理工具。

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

连接哪些道路？
哪里存在多组发生在彼此临近距离和时间内的犯罪？
是否存在多组相互重叠的面？

插图

按邻近性分组工具图示

用法

此地理处理工具适用于 ArcGIS Enterprise 10.9.1 或更高版本。
输出结果是带有名为 group_id 的新字段的输入副本。该 group_id 字段表示要素的分组。具有相同 group_id 值的要素在同一组中。组号表示特定组中的成员身份，并不表示值。重复使用工具时，组号可能不连续或相同。结果将用八组符号表示。如果结果中的组数超过 8 个，则默认情况下所有组都将使用八种颜色进行符号化。您可以修改符号系统以通过在 group_id 字段上使用唯一符号进行符号化来显示每个唯一组。
该工具支持以下关系组合：
- 空间关系
- 空间关系和时态关系
- 空间关系和属性关系
- 空间关系、时态关系和属性关系
当满足所有指定的关系时，系统将对要素进行分组。

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


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


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

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

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


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


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

属性表达式是一种对称运算。该工具将采用在分组时会与自身进行比较的单个输入图层。正因为如此，该输入图层在 ArcGIS Arcade 表达式中将同时以 a 和 b 表示，并且所有的表达式都需要同时包含 a 和 b。例如，要在 Amount 字段具有相同值时对所有记录进行分组，请使用以下表达式：$a["Amount"] == $b["Amount"]。
可执行以下一项或多项操作来提高按邻近性分组工具的性能：
- 设置范围环境，以便仅分析感兴趣的数据。
- 使用空间关系参数的平面邻近或测地线邻近选项时，请使用较小的空间邻近距离参数值。
- 使用空间关系参数时，平面邻近比测地线邻近选项快。
- 使用时间关系参数的邻近选项时，请使用较小的时间邻近距离参数值。
- 使用与分析运行位置同属本地的数据。
该地理处理工具由 ArcGIS GeoAnalytics Server 提供支持。分析将在 GeoAnalytics Server 上完成，且结果将存储在 ArcGIS Enterprise 的您的内容中。
运行 GeoAnalytics Server 工具时，分析将在 GeoAnalytics Server 上完成。要获得最佳性能，请通过在 ArcGIS Enterprise 门户上托管的要素图层或通过大数据文件共享，使 GeoAnalytics Server 可以访问数据。非 GeoAnalytics Server 本地的数据，将在分析开始前移动至 GeoAnalytics Server。这意味着运行工具需要更长时间，并且在某些情况下，从 ArcGIS Pro 到 GeoAnalytics Server 移动数据可能会失败。失败的阈值取决于网络速度，以及数据的大小和复杂性。建议您始终共享数据或创建大数据文件共享。

了解有关将数据共享至您的门户的详细信息

了解有关通过 Server Manager 创建大数据文件共享的详细信息

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

派生输出

标注	说明	数据类型
输出要素图层	包含分组要素的新要素类，这些分组要素由名为 `group_id` 的新字段表示。	Feature Set

arcpy.geoanalytics.GroupByProximity(input_layer, output_name, spatial_relationship, {spatial_near_distance}, {temporal_relationship}, {temporal_near_distance}, {data_store}, {attribute_relationship})

名称	说明	数据类型
input_layer	将对点、线或面要素进行分组。	Feature Set
output_name	具有分组要素的输出要素服务的名称将由新 `group_id` 字段表示。	String
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
data_store （可选）	指定将用于存储输出的 ArcGIS Data Store。在时空大数据存储中存储的所有结果都将存储在 WGS84 中。在关系数据存储中存储的结果都将保持各自的坐标系。 `SPATIOTEMPORAL_DATA_STORE`—输出将存储在时空大数据存储中。这是默认设置。 `RELATIONAL_DATA_STORE`—输出将存储在关系数据存储中。	String
attribute_relationship （可选）	此 ArcGIS Arcade 表达式将用于对要素进行分组。例如，当 `Amount` 字段具有相同的值时，`$a["Amount"] == $b["Amount"]` 将对要素进行分组。	String

派生输出

名称	说明	数据类型
output	包含分组要素的新要素类，这些分组要素由名为 `group_id` 的新字段表示。	Feature Set

代码示例

GroupByProximity 示例（独立脚本）

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

# Name: GroupByProximity.py
# Description: Group roads together that touch
#
# Requirements: ArcGIS GeoAnalytics Server

# Import system modules
import arcpy

# Set local variables
inFeatures = "https://myGeoAnalyticsMachine.domain.com/geoanalytics/rest/services/DataStoreCatalogs/bigDataFileShares_cityData/BigDataCatalogServer/roads"
outFS = "groupedRoads"
overlayType = "TOUCHES"
dataStore = "SPATIOTEMPORAL_DATA_STORE"

# Run Group By Proximity
result = arcpy.geoanalytics.GroupByProximity(inFeatures, outFS,
                                 overlayType, data_store=dataStore)

环境

输出坐标系, 范围, 当前工作空间

特殊情况

输出坐标系: The coordinate system that will be used for analysis. Analysis will be completed in the input coordinate system unless specified by this parameter. For GeoAnalytics Tools, final results will be stored in the spatiotemporal data store in WGS84.

许可信息

基本: 需要 ArcGIS GeoAnalytics Server
适用于 ArcGIS Enterprise 10.9.1
标准: 需要 ArcGIS GeoAnalytics Server
适用于 ArcGIS Enterprise 10.9.1
高级: 需要 ArcGIS GeoAnalytics Server
适用于 ArcGIS Enterprise 10.9.1

按邻近性分组 (GeoAnalytics Server 工具)

汇总

旧版本：

插图

用法

参数

派生输出

环境

特殊情况

许可信息

相关主题