返回顶部

聚合点 (GeoAnalytics)

在本主题中

  1. 摘要
  2. 插图
  3. 使用情况
  4. 参数
  5. 环境
  6. 许可信息

摘要

将点聚合到面要素或图格。 将返回一个多边形，其中包含点计数以及所有存在点的位置的可选统计数据。

了解有关时间步长工作原理的详细信息

插图

聚合点工具
将显示聚合点到面（第一行）、聚合启用时间的点到具有时间步长的面（第二行）、聚合点到条柱（第三行）以及聚合点到具有时间步长的条柱（第四行）的示例。

使用情况

  • 可以使用以下任一方式指定点将聚合的区域：

    • 使用面图层。
    • 使用在运行分析时生成的指定大小的正方形、六边形或 H3 图格。

    您可以提供要用于分析的区域图层，也可以生成点要聚合到的指定大小和形状（六边形、正方形或 H3）的图格。 图格大小参数用于指定正方形和六边形图格的大小。

    • 如果聚合到六边形，则大小为每个六边形的高度，而所生成六边形的宽度为高度除以根号 3 再乘以 2。
    • 如果要聚合到正方形，则图格大小为正方形的高度（等于宽度）。
    • 如果聚合到 H3 图格中，则图格大小由指定的 H3 图格分辨率确定。 H3 图格分辨率的取值范围为 0 到 15，其中 0 表示生成最大的图格，15 表示生成最小的图格。

    六边形或方形条柱

  • 聚合点需要投影点图层参数值，或者在聚合到六边形或正方形图格时，将输出坐标系设置为投影坐标系。 在聚合到六边形和正方形图格时，如果您的数据不在投影坐标系中，并且未设置投影处理坐标系，则将根据您分析的数据范围分配投影。 当聚合到 H3 图格时，点图层参数值必须使用世界大地测量系统 1984 (WKID 4326)，并且根据需要，将转换为该坐标系。

  • 输出要素图层始终是面图层。 仅将返回包含点的面，生成的面将完全从结果图层中移除。

    返回包含点要素的面
    第一张图像显示了输入点和面要素，第二张图像显示了“聚合点”工具生成的面要素。

  • 通过最基本的聚合，对每个面中的点的数量计数进行计算。 统计数据（计数、总和、最小值、最大值、范围、平均值、标准差和方差）还可以根据数值字段进行计算；统计数据（计数、任意）可根据字符串字段进行计算。 将分别计算每个区域的统计数据。 如果指定了无效的统计数据（例如字符串字段的平均值），则将被跳过。

    注：

    将计数应用于字段时，其将返回存在于字段中的非空值的计数。 将任意应用于字段时，其将返回存在于字段中的单个字符串。

  • 如果对输入启用了时间，便可以在分析中应用时间步长。 每个时间步长将独立于时间步长外的要素进行分析。 要使用时间步长，输入数据必须已启用时间且能够表示时刻。 应用时间步长后，输出要素将为 START_DATETIME 和 END_DATETIME 字段表示的时间间隔。

    了解有关时间步长的详细信息

  • 如果指定了时间步长间隔、时间步长重复或参考时间，但数据未启用时间，将会发生错误。

  • 时间步长参考参数可以是日期和时间值或仅为日期值，但不可仅为时间值。

  • 下列字段将包含在输出要素中：

    字段名描述

    count

    每个面内的要素计数。

    statistic_fieldname

    指定的统计数据将分别创建一个属性字段，名称格式如下：statistic_fieldname。 例如，id 字段的最大值和标准差分别为 MAX_id 和 SD_id。

    start_date

    如果指定了时间步长，输出面将具有时间间隔。 该字段表示开始时间。

    end_date

    如果指定了时间步长，输出面将具有时间间隔。 该字段表示结束时间。

    bin_id

    数值型 H3 图格 ID。 仅在聚合到 H3 图格时包括此字段。

  • 您可以通过以下提示来提高聚合点工具的性能：

    • 设置范围环境，以便仅分析感兴趣的数据。
    • 与较小的图格相比，较大的图格性能更佳。 如果对图格大小不确定，可以先使用较大的图格进行原型设计。
    • 与图格类似，与较小的时间步长相比，较大的时间步长性能更佳。
    • 将本地数据用于分析运行的位置。

  • 此地理处理工具由 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 创建大数据文件共享的详细信息

  • 还可以使用“标准要素分析”工具箱中的聚合点工具完成类似性分析。

参数

对话框Python

标注说明数据类型
点图层

将聚合到面或图格的点要素。

Feature Set
输出名称

输出要素服务的名称。

String
面或立方图格

指定如何聚合点图层参数值。

  • 面—点图层将聚合到面数据集。
  • 箱—点图层将聚合到在工具运行时生成的方形或六角条柱。
String
面图层
(可选)

输入点将聚合到的面要素。

Feature Set
立方图格类型
(可选)

指定用于容纳聚合点的图格形状。

  • 平方—将生成正方形图格，其中图格大小值表示正方形的高度。 这是默认设置。
  • 六边形—将生成六边形图格，其中图格大小值表示两个平行边之间的高度。
  • H3—生成 H3 图格。 图格大小由图格分辨率参数值确定。
String
立方图格大小
(可选)

表示点图层值将聚合到的条柱大小和单位的距离间隔。 距离间隔必须为线性单位。

表示点图层将聚合到的条柱大小和单位的距离间隔。 距离间隔必须为线性单位。

Linear Unit
时间步长间隔
(可选)

用来指定时间步长持续时间的值。 只有在输入点启用了时间且表示时刻时，此参数才可用。

只有对输入启用了时间的情况下，才可应用时间步长。

Time Unit
时间步长重复
(可选)

用来指定时间步长间隔发生频率的值。 只有在输入点启用了时间且表示时刻时，此参数才可用。

Time Unit
时间步长参考
(可选)

用来指定时间步长所要对齐的参考时间的日期。 默认情况下为 1970 年 1 月 1 日 12:00 a.m.。只有在输入点启用了时间且表示时刻时，此参数才可用。

Date
汇总字段
(可选)

将根据指定字段进行计算的统计数据。

Value Table
数据存储
(可选)

指定将用于保存输出的 ArcGIS Data Store。 默认设置为时空大数据存储。 在时空大数据存储中存储的所有结果都将存储在 WGS84 中。 在关系数据存储中存储的结果都将保持各自的坐标系。

  • 时空大数据存储—输出将存储在时空大数据存储中。 这是默认设置。
  • 关系数据存储—输出将存储在关系数据存储中。
String
图格分辨率
(可选)

H3 图格的分辨率。 取值范围为 0 到 15，其中 0 表示生成最大的 H3 图格，15 表示生成最小的 H3 图格。

Long

派生输出

标注说明数据类型
输出要素图层

聚合的面要素或条柱。

Feature Set

arcpy.geoanalytics.AggregatePoints(point_layer, output_name, polygon_or_bin, {polygon_layer}, {bin_type}, {bin_size}, {time_step_interval}, {time_step_repeat}, {time_step_reference}, {summary_fields}, {data_store}, {bin_resolution})
名称说明数据类型
point_layer

将聚合到面或图格的点要素。

Feature Set
output_name

输出要素服务的名称。

String
polygon_or_bin

指定如何聚合 point_layer 参数值。

  • POLYGON—点图层将聚合到面数据集。
  • BIN—点图层将聚合到在工具运行时生成的方形或六角条柱。
String
polygon_layer
(可选)

输入点将聚合到的面要素。

Feature Set
bin_type
(可选)

指定用于容纳聚合点的图格形状。

  • SQUARE—将生成正方形图格，其中 bin_size 值表示正方形的高度。 这是默认设置。
  • HEXAGON—将生成六边形图格，其中 bin_size 值表示两个平行边之间的高度。
  • H3—生成 H3 图格。 图格大小由 bin_resolution 参数值确定。
String
bin_size
(可选)

表示 point_layer 值将聚合到的图格大小和单位的距离间隔。 距离间隔必须为线性单位。

Linear Unit
time_step_interval
(可选)

用来指定时间步长持续时间的值。 只有在输入点启用了时间且表示时刻时，此参数才可用。

只有对输入启用了时间的情况下，才可应用时间步长。

Time Unit
time_step_repeat
(可选)

用来指定时间步长间隔发生频率的值。 只有在输入点启用了时间且表示时刻时，此参数才可用。

Time Unit
time_step_reference
(可选)

用来指定时间步长所要对齐的参考时间的日期。 默认情况下为 1970 年 1 月 1 日 12:00 a.m.。只有在输入点启用了时间且表示时刻时，此参数才可用。

Date
summary_fields
[summary_fields,...]
(可选)

将根据指定字段进行计算的统计数据。

  • COUNT - 非空值的数目。 可用于数值字段或字符串。 [null, 0, 2] 的计数为 2。
  • SUM - 字段内数值的总和。 [null, null, 3] 的总和为 3。
  • MEAN - 数值的平均值。 [0,2, null] 的平均值为 1。
  • MIN - 数值字段的最小值。 [0, 2, null] 的最小值为 0。
  • MAX - 数值字段的最大值。 [0, 2, null] 的最大值为 2。
  • STDDEV - 数值字段的标准差。 [1] 的标准差为 null。 [null, 1,1,1] 的标准差为 null。
  • VAR - 轨迹中数值字段内数值的方差。 [1] 的方差为 null。 [null, 1,1,1] 的方差为 null。
  • RANGE - 数值字段的范围。 其计算方法为最大值减去最小值。 [0, null, 1] 的范围为 1。 [null, 4] 的范围为 0。
  • ANY - 字符串型字段中的示例字符串。

Value Table
data_store
(可选)

指定将用于保存输出的 ArcGIS Data Store。 默认为 SPATIOTEMPORAL_DATA_STORE。 在时空大数据存储中存储的所有结果都将存储在 WGS84 中。 在关系数据存储中存储的结果都将保持各自的坐标系。

  • SPATIOTEMPORAL_DATA_STORE—输出将存储在时空大数据存储中。 这是默认设置。
  • RELATIONAL_DATA_STORE—输出将存储在关系数据存储中。
String
bin_resolution
(可选)

H3 图格的分辨率。 取值范围为 0 到 15，其中 0 表示生成最大的 H3 图格，15 表示生成最小的 H3 图格。

Long

派生输出

名称说明数据类型
output

聚合的面要素或条柱。

Feature Set

代码示例

AggregatePoints（Python 窗口）

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

# Name: AggregatePoints.py
# Description: Aggregate 311 events into 1 KM Bins.
#
# Requirements: ArcGIS GeoAnalytics Server

# Import system modules
import arcpy

# Set local variables
inFeatures = "https://sampleserver6.arcgisonline.com/arcgis/rest/services/SF311/FeatureServer/0"
summaryFields = ["Year", "Beat"]
summaryStatistics = [["Arrest", "COUNT"], ["District", "COUNT"]]
outFS = "AggregateWildfires"
dataStore = "SPATIOTEMPORAL_DATA_STORE"

# Run Aggregate Points
arcpy.geoanalytics.AggregatePoints(inFeatures, outFS, "BIN", None, "HEXAGON", 
                                   "1 Kilometers", None, None, None, None, 
                                   dataStore)

环境

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

特殊情况

输出坐标系

将用于分析的坐标系。 除非由该参数进行指定，否则将基于输入坐标系完成分析。 对于 GeoAnalytics Tools，最终结果将存储于 WGS84 中的时空数据存储之内。

许可信息

  • Basic: 需要 ArcGIS GeoAnalytics Server
  • Standard: 需要 ArcGIS GeoAnalytics Server
  • Advanced: 需要 ArcGIS GeoAnalytics Server

相关主题

  • 汇总数据工具集概述
  • 查找地理处理工具
  • 时间步长的工作原理

有关此主题的反馈?

在本主题中
  1. 摘要
  2. 插图
  3. 使用情况
  4. 参数
  5. 环境
  6. 许可信息