Python ArcGIS dissolve_boundaries用法及代碼示例

本文簡要介紹 python 語言中 arcgis.features.analysis.dissolve_boundaries 的用法。

用法:

arcgis.features.analysis.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")