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')