Python ArcGIS trace_downstream用法及代碼示例

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

用法:

arcgis.features.analysis.trace_downstream(input_layer, split_distance=None, split_units='Kilometers', max_distance=None, max_distance_units='Kilometers', bounding_polygon_layer=None, source_database=None, generalize=True, output_name=None, context=None, gis=None, estimate=False, future=False)

返回：

FeatureLayer 如果設置了output_name，否則為 FeatureCollection 。

trace_downstream 方法從分析圖層中的點確定下遊方向的軌跡或流動路徑。

例如，假設您有代表汙染源的點要素，並且您想確定汙染將在您的研究區域中流動的位置。您可以使用trace_downstream 來確定汙染的路徑。通過指定距離值和單位，也可以將此軌跡劃分為單獨的線段。返回的線可以是流動路徑的總長度、指定的最大跡線長度，或剪裁到區域要素(例如您的研究區域)。在很多情況下，如果返回追蹤路徑的總長度，它將是從源頭一直到海洋。

Parameter	Description
input_layer	必需的要素圖層。用於下遊追蹤起始位置的點要素。請參閱特征輸入。
split_distance	可選浮點數。跟蹤線將被分成多條線，其中每條線具有指定的長度。生成的軌跡將具有多個線段，每個線段都有字段 FromDistance 和 ToDistance。
split_units	可選字符串。用於指定分割距離的單位。 選擇列表：[“米”、“公裏”、“英尺”、“碼”、“英裏”]。 默認值為“公裏”。
max_distance	可選浮點數。確定將返回的行的總長度。如果您提供 bounding_polygon_layer 來剪切追蹤，則無論您在此處輸入的距離如何，結果都將被剪切到 bounding_polygon_layer 中的要素。
max_distance_units	可選字符串。用於指定最大距離的單位。 選擇列表：[“米”、“公裏”、“英尺”、“碼”、“英裏”]。 默認值為“公裏”。
bounding_polygon_layer	可選要素圖層。一個多邊形圖層，指定您希望在其中計算追蹤下遊的區域。例如，如果您隻想計算縣多邊形中的下遊追蹤，請提供一個包含縣多邊形和生成的追蹤線的圖層將被剪裁到縣界。請參閱特征輸入。
source_database	可選字符串。表示將在分析中使用的數據源分辨率的關鍵字。 選擇列表：['Finest'，‘30m’, ‘90m’]。 最佳：所有可能數據源中每個位置可用的最佳分辨率。 30m：水文源是從 1 角秒構建的 - 大約 30 米的分辨率，高程數據。 90m：水文源建立在 3 弧秒 - 大約 90 米的分辨率，高程數據。 默認值為“最佳”。
generalize	可選的布爾值。確定輸出跟蹤下遊線是否將平滑為更簡單的線或符合原始 DEM 的單元邊。
output_name	可選字符串或 FeatureLayer 。現有要素圖層將導致新圖層附加到要素服務。如果 overwrite 在上下文中為 True，則新層將覆蓋現有層。如果未指示output_name，則創建新的 FeatureCollection 。
context	可選字典。處理範圍和輸出空間參考等附加設置。對於trace_downstream，有三個設置。 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，表示等待結果。

例子：

# USAGE EXAMPLE: To identify the path the water contamination  will take.
path = trace_downstream(input_layer=water_source_lyr,
                        split_distance=2,
                        split_units='Miles',
                        max_distance=2,
                        max_distance_units='Miles',
                        source_database='Finest',
                        generalize=True,
                        output_name='trace downstream')