Python ArcGIS dissolve_boundaries用法及代码示例

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

用法:

arcgis.features.manage_data.dissolve_boundaries(input_layer, dissolve_fields=[], summary_fields=[], output_name=None, context=None, gis=None, estimate=False, multi_part_features=True, future=False)

返回：

result_layer : FeatureLayer 如果指定了output_name，否则 Feature Collection 。如果 future = True ，则结果是 Future 对象。调用 result() 获取响应。

dissolve_boundaries 方法查找重叠或共享公共边界的多边形并将它们合并在一起以形成单个多边形。

您可以通过指定字段来控制合并哪些边界。例如，如果您有一个县图层，并且每个县都有一个State_Name 属性，则可以使用State_Name 属性融合边界。如果 State_Name 的值相同，相邻县将合并在一起。最终结果是一层状态边界。

Parameter	Description
input_layer	必需的层。包含将被融合的面要素的图层。请参阅特征输入。
dissolve_fields	可选的字符串列表。 input_layer 上的一个或多个字段控制合并哪些多边形。如果您不提供 dissolve_fields ，或者您提供一个空的字段列表，则共享公共边界(即它们是相邻的)的多边形或重叠的多边形区域将被分解为一个多边形。 如果您确实为 dissolve_fields 参数提供了值，那么共享公共边界并在一个或多个字段中包含相同值的多边形将被融合。例如，如果您有一个县图层，并且每个县都有一个State_Name 属性，则可以使用State_Name 属性融合边界。如果 State_Name 的值相同，相邻县将合并在一起。最终结果是一层状态边界。如果指定了两个或多个字段，则这些字段中的值必须相同才能使边界解散。
summary_fields	可选的字符串列表。您希望根据溶解在一起的多边形计算的字段名称和统计摘要类型的列表： [“fieldName summary type”, “fieldName2 summaryType”] fieldName 是在 input_layer 中找到的数字字段之一的名称。 summary type 是以下之一： Sum - 将每个多边形中所有点的总值相加 Mean - 计算每个多边形中所有点的平均值。 Min - 找到每个多边形中所有点的最小值。 Max - 查找每个多边形中所有点的最大值。 Stddev - 找出每个多边形中所有点的标准差。 例如，如果您基于 State_Name 解散县，并且每个县都有一个 Population 字段，则您可以对共享相同 State_Name 属性的所有县求和 Population。结果将是具有总人口的州边界层。 # Usage Example >>> dissolve_boundaries(input_layer="US_Counties", dissolve_fields="State_Name", summary_fields=["Population Sum"], output_name="US_States")
output_name	可选字符串或 FeatureLayer 。现有要素图层将导致新图层附加到要素服务。如果 overwrite 在上下文中为 True，则新层将覆盖现有层。如果未指示output_name，则创建新的 FeatureCollection 。
context	可选字典。处理范围和输出空间参考等附加设置。对于calculate_density，有三个设置。 extent - 定义分析区域的边界框。仅分析input_layer 中与边界框相交的那些特征。 outSR - 输出要素将投影到 wkid 引用的输出空间参考中。 overwrite - 如果为 True，则 output_name 中的要素层将被新要素层覆盖。适用于 ArcGIS Online 或 Enterprise 11+ # 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，将返回运行该操作的积分数。
multi_part_features	可选的布尔值。指定输出要素类中是否允许多部分要素(即共享公共属性表但不可见连接的要素)。 选择列表：[ True , False ] True ：指定允许多部分函数。 False ：指定不允许使用多部分函数。将为每个部分创建单独的特征，而不是创建多部分特征。 默认值为 True 。
future	可选布尔值。如果为 True，则将返回 future 对象，并且进程不会等待任务完成。默认为False，表示等待结果。

例子：

# USAGE EXAMPLE: To dissolve boundaries of polygons with same state name. The dissolved polygons are summarized using population as summary field and standard deviation as summary type.
diss_counties = dissolve_boundaries(input_layer=usa_counties,
                                    dissolve_fields=["STATE_NAME"],
                                    summary_fields=["POPULATION Stddev"],
                                    output_name="DissolveBoundaries")