Python ArcGIS summarize_within用法及代码示例

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

用法:

arcgis.features.analysis.summarize_within(sum_within_layer, summary_layer, sum_shape=True, shape_units=None, summary_fields=[], group_by_field=None, minority_majority=False, percent_shape=False, output_name=None, context=None, gis=None, estimate=False, future=False, bin_type='Square', bin_size=None, bin_size_unit=None)

返回：

result_layer : FeatureLayer 如果指定了 output_name，否则为 FeatureCollection 字典。

带有以下键的dict：

“result_layer”：图层(FeatureCollection)

“group_by_summary”：图层(FeatureCollection)

summarize_within 方法查找位于另一层中的多边形边界内的点、线或多边形要素(或这些要素的一部分)。例如：

• 给定一个流域边界层和一个land-use类型的land-use边界层，计算每个流域的land-use类型的总面积。

• 给定一个县的地块图层和城市边界的图层，总结每个城市边界内的空地块的平均值。

• 给定一层县和一层道路，按道路类型汇总每个县内道路的总里程。

您可以将summarize_within 视为采用两层并将它们堆叠在一起。其中一层，sum_within_layer 必须是一个多边形层，并想象这些多边形边界都是红色的。另一层 summary_layer 可以是任何要素类型的点、线或面。将这些层堆叠在一起后，您向下查看堆栈并计算summary_layer 中落在具有红色边界的多边形内的要素数量(sum_within_layer)。不仅可以统计特征的数量，还可以计算summary_layer中的特征属性的简单统计，例如sum、mean、minimum、maximum等。

Parameter	Description
sum_within_layer	必需 FeatureLayer 。多边形特征。将汇总 summary_layer(如下)中落在这些多边形边界内的要素或要素部分。请参阅特征输入。
summary_layer	必需 FeatureLayer 。将为 sum_within_layer 中的每个多边形汇总的点、线或多边形要素。请参阅特征输入。
sum_shape	可选的布尔值。一个布尔值，指示任务根据 summary_layer 的形状类型计算统计信息，例如 sum_within_layer 中每个多边形内 summary_layer 的线的长度或多边形的面积。 默认值为真。
shape_units	可选字符串。当 sum_shape 设置为 true 时，指定单位以汇总长度或面积。单位不需要汇总点。 当summary_layer 包含多边形时：[‘Acres’, ‘Hectares’, ‘SquareMeters’, ‘SquareKilometers’, ‘SquareMiles’, ‘SquareYards’, ‘SquareFeet’] 当summary_layer 包含以下行时：[‘Meters’, ‘Kilometers’, ‘Feet’, ‘Yards’, ‘Miles’]
summary_fields	可选的字符串列表。您希望为 summary_layer 中的所有要素计算的字段名称和统计汇总类型列表，这些要素位于 sum_within_layer 中的每个多边形内。 示例：[“fieldname1 摘要”，“fieldname2 摘要”]
group_by_field	可选字符串。这是summary_layer 函数的一个字段，可用于分别计算每个唯一属性值的统计数据。例如，假设 sum_within_layer 包含城市边界，而 summary_layer 要素是地块。包的字段之一是状态，它包含两个值：VACANT 和 OCCUPIED。要计算城市边界内空置和占用地块的总面积，请使用状态作为group_by_field 字段。
minority_majority	可选的布尔值。此布尔参数仅在指定 group_by_field 时适用。如果为真，则计算每个组字段的少数(最不占优势)或多数(最占优势)属性值。 result_layer 中添加了两个新字段，前缀为 Majority_ 和 Minority_。 默认值为假。
percent_shape	可选的布尔值。此布尔参数仅在指定 group_by_field 时适用。如果设置为 true，则会为每个 sum_within_layer 多边形计算每个唯一 group_by_field 值的百分比。 默认值为假。
output_name	可选字符串或 FeatureLayer 。现有要素图层将导致新图层附加到要素服务。如果 overwrite 在上下文中为 True，则新层将覆盖现有层。如果未指示output_name，则创建新的 FeatureCollection 。
context	可选字典。处理范围和输出空间参考等附加设置。对于summarize_within，有三个设置。 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}
estimate	可选的布尔值。如果为 True，将返回运行该操作的积分数。
future	可选布尔值。如果为 True，则将返回 future 对象，并且进程不会等待任务完成。默认为False，表示等待结果。
bin_type	必需的字符串。用于计算密度的 bin 类型。 选择列表：[‘六边形’，‘方形’]。
bin_size	所需的浮点数。将使用 input_layer 进行分析的 bin 的距离。生成 bin 时，对于 Square，指定的数量和单位决定了正方形的高度和长度。对于 Hexagon ，指定的数量和单位确定平行边之间的距离。
bin_size_unit	必需的字符串。将为其计算密度的 bin 的距离单位。与 bin_size 中指定的值一起使用的线性单位。 默认值为“米”。

例子：

# USAGE EXAMPLE: To summarize traffic accidents within each county and group them by the day of accident.
acc_within_county = summarize_within(sum_within_layer=boundaries,
                                     summary_layer=collision_lyr,
                                     sum_shape=True,
                                     group_by_field='Day',
                                     minority_majority=True,
                                     percent_shape=True,
                                     output_name='summarize accidents within each county',
                                     context={"extent":{"xmin":-13160690.837046918,"ymin":4041586.5461609075,"xmax":-13132466.464352652,"ymax":4058001.397985127,"spatialReference":{"wkid":102100,"latestWkid":3857}}})