评估点聚合的图格大小 (空间统计工具)

汇总

当在方形或六边形格网中聚合点时，评估多个图格大小并建议合适的图格大小。此工具可通过对点事件计数或对每个图格中的分析字段值进行平均来聚合。也可以使用该工具来评估其他各种图格大小，以确定聚合结果和模式变化的方式。

该工具的输入是将进行聚合的点、可选的分析字段、图格类型（六边形或方形）以及定义点可能出现的位置的聚合边界面（例如城市中树木位置的城市边界）。输出为面图格以及图表，用于探索各种图格大小的结果。

或者，可提供时间字段和时间间隔，以便在将点聚合到时空图格中时估计图格大小。

了解有关“评估点聚合的图格大小”工作原理的详细信息

插图

“评估点聚合的图格大小”工具图示

用法

该工具通过计算两个条件来评估每个已检验图格大小：一个条件通常更倾向于较小的图格大小，另一个条件通常更倾向于较大的图格大小。然后，对两个条件进行组合以得出图格大小的最终评估得分，评估得分越高，则图格大小在平衡这两个条件时的性能越优异。

了解有关评估得分的详细信息
聚合边界参数用于定义将聚合点的区域（有时称为研究区域），并且应表示点可能出现和记录的区域。要估计适当的图格大小，重要的是要区分某个区域是否因为没有发生任何事件而没有点（例如某个城市的某个区域在某一周没有发生抢劫）或者是否不可能在该区域中观察到点（例如在陆地上看到鲸鱼）。

当提供了分析字段时，聚合边界的重要性会降低，因为只能为至少包含一个点的图格计算其均值。然而，仍建议提供能够良好体现点要素分布的边界。

了解有关聚合边界的详细信息
该工具将创建一个图层组，用于保存该工具的输出。输出将包含使用建议图格大小的面图格、评估分数的表和图表，以及聚合边界面。建议图格大小也作为导出输出包含在内，并显示在消息中。

了解有关工具输出的详细信息
该工具假设存在适用于对点进行聚合的单一图格大小。但是，在许多情况下，并不存在将充分代表整个聚合边界内所有点情况的单一图格大小。例如，在一个既包含人口密度较低的农村区域又包含人口密度较高的城市区域的大型县域中，可能难以在整个县域范围内对紧急呼叫进行聚合。如果图格大小足够小，能够准确呈现城市区域的特征，则农村区域的图格大多为空；而如果图格大小对于农村区域足够大，则会将城市中心压缩至仅少数几个图格中。此问题的常见表现是：建议图格大小周围的置信区间非常宽，这表明对于应选用何种图格大小存在高度不确定性。一种可能的解决方案是将点分隔到不同的数据集中，并针对各数据集分别使用不同的图格大小对其进行聚合。
您可以利用时间字段和时间间隔参数聚合空间和时间点。例如，如果您有代表一整年期间紧急呼叫的点数据，并希望按每周进行聚合，该工具会推荐适用于全年每一周的最优图格大小。这对于将点要素聚合为时空立方体特别有用。

了解有关聚合空间和时间点的详细信息

若需基于此工具的结果创建时空立方体，请将这些点要素作为通过聚合点创建时空立方体工具的输入，并在距离间隔参数中提供工具推荐的图格大小。您还必须使用相同的聚合形状类型（正方形或六边形），并在时间步长间隔参数中提供时间间隔。

标注	说明	数据类型
输入点要素	将聚合到图格中的输入点。	Feature Layer
输出要素类	输出面图格，其中包含每个图格内的点计数。	Feature Class
图表的输出评估得分表	输出表，将包含所有图格大小的评估得分。该表将随附显示评估得分的图表。	Table
输出聚合边界面	将用于创建图格的聚合边界面。	Feature Class
图格类型（可选）	指定每个图格的形状。方形—可将点聚合到正方形图格中。六边形—可将点聚合到六边形图格中。这是默认设置。	String
聚合边界（可选）	指定将点聚合到六边形或正方形图格中的边界或研究区域，并且图格仅在与聚合边界相交时，才会包含在输出要素类中。边界应定义点可能出现的区域。要估计适当的图格大小，重要的是要区分某个区域是否因为没有发生任何事件而没有点（例如某个城市的某个区域在某一周没有发生抢劫）或者是否不可能在该区域中观察到点（例如在陆地上看到鲸鱼）。使用过大的聚合边界（包含许多不可能记录或未记录点的区域）通常会导致图格大小将大得不切实际。凸包—输入点的凸包将为聚合的边界。包络矩形—输入点的矩形包络将为聚合的边界。自定义面—自定义面要素类将为聚合的边界。凹包—输入点的凹包（阿尔法形状）将为聚合的边界。这是默认设置。	String
自定义面（可选）	将用作聚合边界的自定义面。	Feature Layer
分析字段（可选）	将在每个图格中进行平均的数值字段。如果未提供任何字段，图格将包含图格中的点计数。	Field
合并重合点（可选）	指定是否将对重合点（位于同一位置的点）的分析字段值进行平均并视为单个点。选中—将对重合点的分析字段值进行平均并视为单个点。这是默认设置。未选中—将全部重合点视为单独的点。	Boolean
时间字段（可选）	该字段表示事件发生或记录分析字段值的时间。如已提供，点将划分为时间间隔。	Field
时间间隔（可选）	将用于划分点为不同时间片的时间间隔。间隔从点的最新时间开始向后（更早的时间）推算。例如，如果最新时间字段值为 12 月 15 日中午且时间间隔为 5 天，则 12 月 10 日中午之后的所有点都将位于同一时间间隔。同样，12 月 5 日中午到 12 月 10 日中午之间的所有点也将位于同一时间间隔。同一时间间隔内的所有点将视为在同一时间发生。两个时间间隔边界上的点将包含在较早的时间间隔中。	Time Unit

派生输出

标注	说明	数据类型
输出图格大小	用于创建输出要素类的具有最高评估得分的图格大小。单位为图格的高度（对于正方形，它也是边长）。	Double
输出图层组	将包含输出要素、输出表和输出聚合边界面的输出图层组。	Group Layer

arcpy.stats.EvaluateBinSizes(in_point_features, out_features, out_charts_table, out_agg_bdry, {bin_type}, {aggregation_boundary}, {custom_polygons}, {analysis_field}, {combine_coincident_pts}, {time_field}, {time_interval})

名称	说明	数据类型
in_point_features	将聚合到图格中的输入点。	Feature Layer
out_features	输出面图格，其中包含每个图格内的点计数。	Feature Class
out_charts_table	输出表，将包含所有图格大小的评估得分。该表将随附显示评估得分的图表。	Table
out_agg_bdry	将用于创建图格的聚合边界面。	Feature Class
bin_type （可选）	指定每个图格的形状。 `SQUARE`—可将点聚合到正方形图格中。 `HEXAGON`—可将点聚合到六边形图格中。这是默认设置。	String
aggregation_boundary （可选）	指定将点聚合到六边形或正方形图格中的边界或研究区域，并且图格仅在与聚合边界相交时，才会包含在输出要素类中。边界应定义点可能出现的区域。要估计适当的图格大小，重要的是要区分某个区域是否因为没有发生任何事件而没有点（例如某个城市的某个区域在某一周没有发生抢劫）或者是否不可能在该区域中观察到点（例如在陆地上看到鲸鱼）。使用过大的聚合边界（包含许多不可能记录或未记录点的区域）通常会导致图格大小将大得不切实际。 `CONVEX_HULL`—输入点的凸包将为聚合的边界。 `ENVELOPE`—输入点的矩形包络将为聚合的边界。 `CUSTOM`—自定义面要素类将为聚合的边界。 `CONCAVE_HULL`—输入点的凹包（阿尔法形状）将为聚合的边界。这是默认设置。	String
custom_polygons （可选）	将用作聚合边界的自定义面。	Feature Layer
analysis_field （可选）	将在每个图格中进行平均的数值字段。如果未提供任何字段，图格将包含图格中的点计数。	Field
combine_coincident_pts （可选）	指定是否将对重合点（位于同一位置的点）的分析字段值进行平均并视为单个点。 `COMBINE`—将对重合点的分析字段值进行平均并视为单个点。这是默认设置。 `NO_COMBINE`—将全部重合点视为单独的点。	Boolean
time_field （可选）	该字段表示事件发生或记录分析字段值的时间。如已提供，点将划分为时间间隔。	Field
time_interval （可选）	将用于划分点为不同时间片的时间间隔。间隔从点的最新时间开始向后（更早的时间）推算。例如，如果最新时间字段值为 12 月 15 日中午且时间间隔为 5 天，则 12 月 10 日中午之后的所有点都将位于同一时间间隔。同样，12 月 5 日中午到 12 月 10 日中午之间的所有点也将位于同一时间间隔。同一时间间隔内的所有点将视为在同一时间发生。两个时间间隔边界上的点将包含在较早的时间间隔中。	Time Unit

派生输出

名称	说明	数据类型
out_bin_size	用于创建输出要素类的具有最高评估得分的图格大小。单位为图格的高度（对于正方形，它也是边长）。	Double
output_layer_group	将包含输出要素、输出表和输出聚合边界面的输出图层组。	Group Layer

代码示例

EvaluateBinSizes 示例 1（Python 窗口）

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

# Aggregate emergency calls within a city.
import arcpy
arcpy.env.workspace = r"c:\mydata\mydata.gdb"
arcpy.stats.EvaluateBinSizes(
    in_point_features="emergency_calls",
    out_features=r"emergency_call_bins",
    out_charts_table=r"out_evaluation_table",
    out_agg_bdry=r"out_agg_boundary",
    bin_type="HEXAGON",
    aggregation_boundary="CUSTOM",
    custom_polygons="city_boundary"
)

EvaluateBinSizes 示例 2（独立脚本）

以下独立脚本演示了如何使用 EvaluateBinSizes 函数。

# Aggregate emergency calls within a city.

import arcpy

# Set the current workspace.
arcpy.env.workspace = r"c:\mydata\mydata.gdb"

# Run tool

arcpy.stats.EvaluateBinSizes(
    in_point_features="emergency_calls",
    out_features=r"emergency_call_bins",
    out_charts_table=r"out_evaluation_table",
    out_agg_bdry=r"out_agg_boundary",
    bin_type="HEXAGON",
    aggregation_boundary="CUSTOM",
    custom_polygons="city_boundary"
)

# Print the messages.
print(arcpy.GetMessages())

环境

范围, 输出坐标系, 并行处理因子, 随机数生成器

许可信息

基本: 是
标准: 是
高级: 是

评估点聚合的图格大小 (空间统计工具)

汇总

插图

用法

参数

派生输出

环境

许可信息

相关主题