Python ArcGIS aggregate_points用法及代码示例

本文简要介绍 python 语言中 arcgis.features.analysis.aggregate_points 的用法。

用法:

arcgis.features.analysis.aggregate_points(point_layer, polygon_layer=None, keep_boundaries_with_no_points=True, summary_fields=[], group_by_field=None, minority_majority=False, percent_points=False, output_name=None, context=None, gis=None, estimate=False, future=False, bin_type=None, bin_size=None, bin_size_unit=None)

返回：

result_layer：如果指定了output_name，则为 FeatureLayer ，否则为 FeatureCollection 。

聚合点任务使用一层点要素和一层面要素。它首先确定哪些点落在每个多边形的区域内。确定此point-in-polygon 空间关系后，将计算有关多边形中所有点的统计数据并将其分配给该区域。最基本的统计数据是多边形内的点数，但您也可以获得其他统计数据。

例如，如果您的点代表咖啡店，并且每个点都有一个TOTAL_SALES 属性，那么您可以获得多边形内所有TOTAL_SALES 的总和，或最小或最大TOTAL_SALES 值或标准差等统计信息多边形内的所有销售。

Parameter	Description
point_layer	所需的点图层。将聚合到polygon_layer 中的多边形中的点要素。请参阅特征输入。
polygon_layer	可选的多边形层。将聚合输入点的面要素(区域)。看特征输入.这polygon_layer是必需的如果bin_type,bin_size和bin_size_unit未指定。
keep_boundaries_with_no_points	可选的布尔值。一个布尔值，指定是否应在输出中返回其中没有点的多边形。默认值为真。
summary_fields	可选的字符串列表。您希望为每个多边形内的所有点计算的字段名称和统计汇总类型的列表。请注意，始终返回每个多边形内的点数。摘要类型是以下之一： Sum - 将每个多边形中所有点的总值相加 平均值 - 计算每个多边形中所有点的平均值。 Min - 查找每个多边形中所有点的最小值。 Max - 查找每个多边形中所有点的最大值。 Stddev - 找出每个多边形中所有点的标准差。 示例 [fieldName1 summaryType1,fieldName2 summaryType2]。
group_by_field	可选字符串。 point_layer 中的字段名称。分组依据字段具有相同值的点将具有自己的计数和汇总字段统计信息。您可以使用分析图层中的属性创建统计组。例如，如果您将犯罪聚集到社区边界，您可能有一个属性 Crime_type，其中包含五种不同的犯罪类型。每个独特的犯罪类型形成一个组，您选择的统计数据将针对 Crime_type 的每个唯一值进行计算。选择分组属性时，会创建两个结果：结果图层和包含统计信息的相关表。
minority_majority	可选的布尔值。此布尔参数仅在指定group_by_field 时适用。如果为真，则计算每个边界内每个组字段的少数(最不占优势)或多数(最占优势)属性值。 aggregated_layer 中添加了两个新字段，前缀为 Majority_ 和 Minority_。默认值为假。
percent_points	可选的布尔值。此布尔参数仅在指定group_by_field 时适用。如果设置为 true，则计算每个唯一 group_by_field 值的点数百分比。一个新字段被添加到组汇总输出表中，其中包含每个组内每个属性值的百分比。 如果minority_majority 为真，则会向aggregated_layer 添加两个附加字段，其中包含每个组中少数属性值和多数属性值的百分比。
output_name	可选字符串或 FeatureLayer 。现有要素图层将导致新图层附加到要素服务。如果 overwrite 在上下文中为 True，则新层将覆盖现有层。如果未指示output_name，则创建新的 FeatureCollection 。
context	可选字典。其他设置，例如处理范围和输出空间参考。对于aggregate_points，有三个设置(需要overwrite)。 extent - 定义分析区域的边界框。仅分析input_layer 中与边界框相交的那些特征。 outSR - 输出要素将投影到 wkid 引用的输出空间参考中。 overwrite - 如果为 True，则 output_name 中的要素层将被新要素层覆盖。适用于 ArcGIS Online 或 Enterprise 10.9.1+ # Example Usage context = {"extent": {"xmin": 3164569.408035, "ymin": -9187921.892449, "xmax": 3174104.927313, "ymax": -9175500.875353, "spatialReference":{"wkid":102100,"latestWkid":3857}}, "outSR": {"wkid": 3857}, "overwrite": True}
gis	可选，运行此工具的 GIS 。如果未指定，则使用活动 GIS。
estimate	可选布尔值。如果为 True，将返回运行该操作的积分数。
future	可选布尔值。如果为 True，则将返回 future 对象，并且进程不会等待任务完成。默认为False，表示等待结果。
bin_type	可选字符串。将生成的 bin 类型和将聚合到的点。 Bin 选项如下：Hexagon 和 Square。正方形是默认值。生成 bin 时，对于 Square，指定的数量和单位决定了正方形的高度和长度。对于六边形，指定的数量和单位确定平行边之间的距离。必须指定bin_type 或polygon_layer。如果选择bin_type，则必须包括指定箱大小的bin_size 和bin_size_unit。
bin_size	可选浮点数。 point_layer 将被聚合到的类型为 bin_type 的 bin 的距离。为 Square 生成 bin 时，指定的数量和单位决定了正方形的高度和长度。对于 Hexagon ，指定的数量和单位确定平行边之间的距离。
bin_size_unit	可选字符串。与 bin_size 中指定的距离值一起使用的线性单位。值：Meters, Kilometers, Feet, Miles, NauticalMiles, or Yards

如果 future = True ，则结果是 Future 对象。调用result() 获取响应。

例子：

# USAGE EXAMPLE: To find number of permits issued in each zip code of US.

agg_result = aggregate_points(point_layer=permits,
                        polygon_layer=zip_codes,
                        keep_boundaries_with_no_points=False,
                        summary_fields=["DeclValNu mean","DeclValNu2 mean"],
                        group_by_field='Declared_V',
                        minority_majority=True,
                        percent_points=True,
                        output_name="aggregated_permits",
                        context={"extent":{"xmin":-8609738.077325115,"ymin":4743483.445485223,"xmax":-8594030.268012533,"ymax":4752206.821338257,"spatialReference":{"wkid":102100,"latestWkid":3857}}})