Python ArcGIS watershed用法及代碼示例

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

用法:

arcgis.features.hydrology.watershed(input_points, point_id_field=None, snap_distance=10, snap_distance_units='Meters', source_database='Finest', generalize=False, gis=None, return_snapped_points=True, future=False)

返回：

結果對象由兩個FeatureSets - 一個用於watershed_area，另一個用於snapped_points

watershed 用於根據您提供的特定位置和 ArcGIS 在線高程數據來識別集水區。

Parameter	Description
input_points	必需的 FeatureSet 或空間啟用數據幀。說明計算下遊位置的起始位置的點。請參閱特征輸入。
point_id_field	可選字符串。用於從源數據中識別特征的字段。這對於將結果關聯回原始源數據很有用。
snap_distance	可選浮點數。移動輸入點位置的最大距離。 交互式輸入點和記錄的量規位置可能與 DEM 中的流位置不完全一致。此參數允許任務將點移動到具有最大貢獻區域的附近位置。 捕捉距離應始終大於源數據分辨率。默認情況下，捕捉距離的計算方法是源數據的分辨率乘以 5。 默認值為 10。
snap_distance_units	可選字符串。為捕捉距離指定的線性單位。 選擇列表：[“米”、“公裏”、“英尺”、“碼”、“英裏”]。 默認值為“米”。
source_database	可選字符串。表示將在分析中使用的源數據的關鍵字。該關鍵字是用於構建基礎水文數據庫的數字高程模型的空間分辨率的近似值。由於許多高程源都以弧秒為單位分布，因此該關鍵字是一個以米為單位的近似值，以便於理解。 Finest ：所有可能的數據源中每個位置可用的最高分辨率。 10m：水文源是從 1/3 角秒構建的 - 大約 10 米的分辨率，高程數據。 30m：水文源從 1 角秒構建 - 大約 30 米分辨率，高程數據。 90m：水文源是從 3 弧秒構建的 - 大約 90 米的分辨率，高程數據。 默認值為“最佳”。
generalize	可選的布爾值。確定輸出的下遊跟蹤線是否將被平滑成更簡單的線。 默認值為假。
gis	可選的 GIS 對象實例。如果未作為輸入提供，則必須已在活動 Python 會話中創建登錄到活動門戶並定義了高程幫助程序服務的 GIS 對象實例。還可以選擇通過此參數顯式傳入 GIS 對象實例。
return_snapped_points	可選的布爾值。確定是否將返回流域傾瀉點處的點要素。如果啟用捕捉，這可能與輸入點不同。 默認值是true。
future	可選布爾值。如果為 True，則將返回 future 對象，並且進程不會等待任務完成。默認為False，表示等待結果。

例子：

# USAGE EXAMPLE: To identify catchment areas around Chennai lakes.
lakes_watershed = watershed(input_points=lakes_fs,
                            snap_distance=10,
                            snap_distance_units='Meters',
                            source_database='Finest',
                            generalize=False)