当前位置: 首页>>代码示例 >>用法及示例精选 >>正文


Python ArcGIS trace_downstream用法及代码示例


本文简要介绍 python 语言中 arcgis.trace_downstream 的用法。

用法:

arcgis.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.png

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

相关用法


注:本文由纯净天空筛选整理自arcgis.com大神的英文原创作品 arcgis.trace_downstream。非经特殊声明,原始代码版权归原作者所有,本译文未经允许或授权,请勿转载或复制。