Python ArcGIS optimal_region_connections用法及代碼示例

本文簡要介紹 python 語言中 arcgis.raster.analytics.optimal_region_connections 的用法。

用法:

arcgis.raster.analytics.optimal_region_connections(input_region_data, input_barrier_data=None, input_cost_raster=None, distance_method='PLANAR', connections_within_regions='GENERATE_CONNECTIONS', output_optimal_lines_name=None, output_neighbor_connections_name=None, context=None, *, gis=None, future=False, **kwargs)

返回：

返回以下作為命名元組 - output_optimum_network_features、output_neighbor_network_features

計算兩個或多個輸入區域之間的最佳連接網絡。 ArcGIS Image Server 10.8.1 及更高版本中可用的函數。

Parameter	Description
input_region_data	必需的 ImageryLayer 或 FeatureLayer 對象。傳送門物品可以通過。由最優網絡連接的輸入區域。 如果區域輸入是柵格，則區域由具有相同值的連續(相鄰)像元組定義。每個區域必須具有唯一編號。不屬於任何區域的像元必須是 NoData。柵格類型必須是整數，並且值可以是正數或負數。 如果區域輸入是要素數據集，則它可以是麵、線或點。麵要素區域不能由多部分麵組成。
input_barrier_data	必需的 ImageryLayer 或 FeatureLayer 對象。傳送門物品可以通過。定義障礙的數據集。 障礙可以由整數或浮點柵格或要素圖層定義。
input_cost_raster	必需的 ImageryLayer 對象。傳送門物品可以通過。定義平麵移動通過每個像元的阻抗或成本的柵格。 每個單元格位置的值表示移動通過單元格的cost-per-unit 距離。每個像元位置值乘以像元分辨率，同時還補償對角線移動以獲得通過像元的總成本。 成本柵格的值可以是整數或浮點數，但它們不能為負數或零(您不能有負數或零成本)。
distance_method	可選字符串。指定是使用平麵(平坦地球)還是測地線(橢球)方法計算距離。 PLANAR - 距離計算將使用 2D 笛卡爾坐標係在投影平麵上執行。這是默認設置。 GEODESIC - 距離計算將在橢球體上執行。因此，無論輸入或輸出投影，結果都不會改變。
connections_within_regions	可選字符串。默認 - GENERATE_CONNECTIONS 可能的選項：GENERATE_CONNECTIONS、NO_CONNECTIONS
output_optimal_lines_name	可選的。如果未提供，則由該方法創建要素圖層並將其用作輸出。您可以從 GIS 中傳入現有要素圖層項目以使用它。或者，您可以傳入應通過此方法創建的輸出要素圖層的名稱，以用作工具的輸出。如果該名稱的服務已經存在，則會引發 RuntimeError 這是連接每個輸入區域所需的最佳路徑網絡的輸出折線要素類。 每條路徑(或行)都有唯一編號，屬性表中的附加字段存儲有關路徑的特定信息。這些字段如下： PATHID - 路徑的唯一標識符 PATHCOST - 路徑的總累積距離或成本 REGION1 - 路徑連接的第一個區域 REGION2 - 路徑連接的另一個區域 此信息提供對網絡內路徑的深入了解。 由於每條路徑都由一條唯一的線表示，因此在路徑經過相同路線的位置會有多條線。
output_neighbor_connections_name	可選的。如果未提供，則由該方法創建要素圖層並將其用作輸出。您可以從 GIS 中傳入現有要素圖層項目以使用它。或者，您可以傳入應通過此方法創建的輸出要素圖層的名稱，以用作工具的輸出。如果該名稱的服務已經存在，則會引發 RuntimeError 這是輸出折線要素類，用於標識從每個區域到每個最近鄰域或成本鄰域的所有路徑。 每條路徑(或行)都有唯一編號，屬性表中的附加字段存儲有關路徑的特定信息。這些字段如下： PATHID - 路徑的唯一標識符 PATHCOST - 路徑的總累積距離或成本 REGION1 - 路徑連接的第一個區域 REGION2 - 路徑連接的另一個區域 此信息提供對網絡內路徑的深入了解，並且在決定在必要時應刪除哪些路徑時特別有用。 由於每條路徑都由一條唯一的線表示，因此在路徑經過相同路線的位置會有多條線。
context	上下文包含影響任務執行的其他設置。
gis	可選的 GIS 對象。如果未指定，則使用當前活動的連接。
future	僅關鍵字參數。可選的布爾值。如果為 True，則結果將是一個 GPJob 對象，並且結果將異步返回。
folder	僅關鍵字參數。可選的 str 或 dict。使用給定的文件夾名稱在門戶中創建一個文件夾(如果不存在)，並將輸出保留在此文件夾中。 gis.content.create_folder 返回的字典也可以作為輸入傳入。 例子： {‘username’: ‘user1’, ‘id’: ‘6a3b77c187514ef7873ba73338cf1af8’, ‘title’: ‘trial’}

例子：

# Usage Example 1: To calculate the optimal connections between regions.

region_data = gis.content.search("my_region_data")[0].layers[0]
barrier_data = gis.content.search("my_barrier_data")[0].layers[0]
cost_raster = gis.content.search("my_cost_raster")[0].layers[0]

optimal_region_op = optimal_region_connections(input_region_data=region_data,
                                               input_barrier_data=barrier_data,
                                               input_cost_raster=cost_raster,
                                               output_optimal_lines_name="optimal_lines_feature",
                                               output_neighbor_connections_name="optimal_region_feature",
                                               gis=gis)