聚合点 (GeoAnalytics Desktop)

摘要

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

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

插图

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

使用情况

  • 可通过以下两种方法指定点将聚合到的区域:

    • 使用面图层。
    • 使用在运行分析时生成的指定尺寸的方形立方图格或六边形立方图格。

    您可以提供要用于分析的区域图层,也可以生成要聚合到的指定大小和形状(六边形或正方形)的立方图格。立方图格大小将指定立方图格的大小。如果聚合到六边形,则大小为每个六边形的高度,而所生成六边形的宽度为高度除以根号 3 再乘以 2。如果要聚合到正方形,则立方图格大小为正方形的高度(等于宽度)。

    六边形或方形立方图格
  • 使用条柱的分析要求您的输入已投影或输出坐标系设置为投影坐标系。 如果您的数据不在投影坐标系中,并且未设置投影坐标系,则将根据您分析的数据范围使用投影。

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

    包含点要素的所返回面
    随即将显示输入点和面要素(左)以及通过“聚合点”生成的面要素(右)。

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

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

  • 通过最基本的聚合,对每个面中的点数进行计算。统计数据(计数、总和、最小值、最大值、范围、平均值、标准差和方差)还可以根据数值字段进行计算;统计数据(计数、任意)可根据字符串字段进行计算。系统将分别计算每个区域的统计数据。如果您指定的统计信息无效(字符串字段的平均值),则将跳过该统计信息。

    注:

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

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

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

  • 如果您指定时间步长间隔、时间步长重复或参考时间,但并没有对数据启用时间,则此工具会出错。

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

  • 下列字段也包含在输出要素中:

    字段名描述

    count

    每个面内的要素计数。

    statistic_fieldname

    指定的统计信息将各自创建一个属性字段,并按照以下格式命名:statistic_fieldname。例如,id 字段的最大值和标准差分别为 MAX_idSD_id

    start_date

    指定时间步长后,输出面将有一个时间间隔。该字段表示开始时间。

    end_date

    指定时间步长后,输出面将有一个时间间隔。该字段表示结束时间。

  • 您可以使用以下一个或多个提示来提升聚合点工具的性能:

    • 设置范围环境,以便仅分析感兴趣的数据。
    • 较大的立方图格比较小的立方图格性能更佳。如果不确定使用哪种大小,可从较大的立方图格开始原型化。
    • 与立方图格类似,较大的时间步长比较小的时间步长性能更佳。
    • 本地数据用于分析运行的位置。

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

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

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

参数

标注说明数据类型
点图层

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

Feature Layer
输出要素类

包含所聚合面结果的新要素类。

Feature Class
面或立方图格

指定点图层的聚合方式。

  • 点图层将聚合到面数据集。
  • 图格点图层将聚合到运行此工具时生成的方形或六角立方图格。
String
面图层
(可选)

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

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

指定将生成的用于保存聚合点的立方图格形状。

  • 正方形将生成方形立方图格,其中立方图格大小表示方形的高度。这是默认设置。
  • 六边形将生成六边形立方图格,其中图格大小表示两条平行边之间的高度。
String
立方图格大小
(可选)

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

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

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

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

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

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

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

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

Date
汇总字段
(可选)

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

Value Table

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

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

Feature Layer
out_feature_class

包含所聚合面结果的新要素类。

Feature Class
polygon_or_bin

指定 point_layer 的聚合方式。

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

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

Feature Layer
bin_type
(可选)

指定将生成的用于保存聚合点的立方图格形状。

  • SQUARE将生成方形立方图格,其中 bin_size 表示方形的高度。这是默认设置。
  • HEXAGON将生成六边形立方图格,其中 bin_size 表示两条平行边之间的高度。
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

代码示例

AggregatePoints(Python 窗口)

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

# Name: AggregatePoints.py
# Description: Aggregate 311 events into 1 KM Bins.

# Import system modules
import arcpy

arcpy.env.workspace = "C:/data/CityData.gdb"

# Set local variables
inFeatures = "SF311"
summaryFields = ["Year", "Beat"]
summaryStatistics = [["Arrest", "COUNT"], ["District", "COUNT"]]
out = "AggregateWildfires"

# Run Aggregate Points
arcpy.gapro.AggregatePoints(inFeatures, out, "BIN", None, "HEXAGON", 
                            "1 Kilometers")