生成溃口线 (Spatial Analyst 工具)

汇总

创建用于突破局部水流阻碍的线。

用法

洼地是地形上低于周围地形、会阻碍水流的区域。 生成溃口线工具会找到一条溃口线，将洼地与下游点连接，确保水文连通。
输出溃口线参数值表示挖掘每个洼地多边形以确保水文连通性的线。 输入洼地面（Python 中的 in_depression_polygons）参数值表示要挖掘的每个洼地多边形。
输入连接点（Python 中的 in_connection_points）参数值表示溃口线将连接的起点和终点。可以使用定位洼地工具创建。
输入连接点要素图层应具有两个字段。第一个字段 DEP_ID 是该点所属洼地的 ID。二进制字段 POINT_TYPE 指定该点标记的是待生成线的起点（值为 0）还是终点（值为 1）。
输出要素图层中的溃口线始终起始于洼地内的某一点，并终止于高程较低的像元位置，以确保产生水流。该工具不会创建仅部分覆盖此路径的线。换句话说，不会创建局部或不完整的线。
对于每个洼地多边形，输出溃口线均起始于洼地内的最低高程点。线的终点取决于为追踪方法（Python 中的 trace_method）参数值指定的选项。
当为追踪方法参数值指定最短路径（Python 中的 SHORTEST_PATH）选项时，每个洼地的输入连接点参数值中必须同时存在起点和终点。
当为追踪方法指定最低溃口成本（Python 中的 MIN_BREACHING_COST）选项时，输出溃口线表示根据 Lindsay 和 Dhun (2015) 使路径溃口成本最小化的路径。溃口成本等于为创建连接洼地与另一个较低高程像元位置的河道以确保水流而需要降低或挖掘的高程量。
如果指定了掩膜环境设置，则仅当起点（位于洼地内）处于掩膜区域内时，工具才会生成溃口线。洼地区域可以完全或部分位于掩膜区域内。
有关适用于此工具的地理处理环境的详细信息，请参阅分析环境和 Spatial Analyst。

标注	说明	数据类型
输入洼地面	包含定义洼地区域的面的输入要素图层。洼地是地形上低于周围地形、会阻碍水流的区域。	Feature Layer
输入表面栅格	输入表面栅格。	Raster Layer
输出溃口线	输出要素类，将包含用于连接洼地与下游像元并确保水文连通性的线。每条线都有唯一的编号。属性表中的其他字段用于存储有关点的特定信息。这些字段包括： `LENGTH`—溃口线的长度，以米为单位。 `DEP_ID`—与线相关联的洼地的标识符。 `START_X`—溃口线起点的 X 坐标。 `START_Y`—溃口线起点的 Y 坐标。 `END_X`—溃口线终点的 X 坐标。 `END_Y`—溃口线终点的 Y 坐标。这四个坐标字段的值基于输出空间参考。	Feature Class
输入连接点（可选）	用于定义洼地中最低高程点和相应下游连接点的可选输入点。当追踪方法参数值设置为最短路径时，需要此输入。属性表中预期的字段包括： `DEP_ID`—与点相关联的洼地的标识符。 `POINT_TYPE`—一个布尔字段，其中值 0 表示该点为洼地中的最低高程点，值 1 表示该点为下游连接点。	Feature Layer
追踪方法（可选）	指定用于构建溃口线的方法。可选方法如下：最低溃口成本—线将沿着使溃口成本最小的路径延伸。这是默认设置。最短路径—起点与终点之间距离最短的路径。此方法要求输入连接点参数值中同时包含起点和终点。此路径将是突破局部水流阻碍的最短连线。最小高程变化—线将沿着使高程变化最小的路径延伸。	String
最大长度（可选）	溃口线允许的最大长度。如果某条潜在的溃口线超过此限制，将不会被包含在输出溃口线要素类中。默认值为 50 米或分析空间参考的地图单位的等效值。	Linear Unit

GenerateBreachLines(in_depression_polygons, in_surface_raster, out_breach_lines, {in_connection_points}, {trace_method}, {max_length})

名称	说明	数据类型
in_depression_polygons	包含定义洼地区域的面的输入要素图层。洼地是地形上低于周围地形、会阻碍水流的区域。	Feature Layer
in_surface_raster	输入表面栅格。	Raster Layer
out_breach_lines	输出要素类，将包含用于连接洼地与下游像元并确保水文连通性的线。每条线都有唯一的编号。属性表中的其他字段用于存储有关点的特定信息。这些字段包括： `LENGTH`—溃口线的长度，以米为单位。 `DEP_ID`—与线相关联的洼地的标识符。 `START_X`—溃口线起点的 X 坐标。 `START_Y`—溃口线起点的 Y 坐标。 `END_X`—溃口线终点的 X 坐标。 `END_Y`—溃口线终点的 Y 坐标。这四个坐标字段的值基于输出空间参考。	Feature Class
in_connection_points （可选）	用于定义洼地中最低高程点和相应下游连接点的可选输入点。当 `trace_method` 参数值设置为 `SHORTEST_PATH` 时，需要此输入。属性表中预期的字段如下： `DEP_ID`—与点相关联的洼地的标识符。 `POINT_TYPE`—一个布尔字段，其中值 0 表示该点为洼地中的最低高程点，值 1 表示该点为下游连接点。	Feature Layer
trace_method （可选）	指定用于构建溃口线的方法。可选方法如下： `MIN_BREACHING_COST`—线将沿着使溃口成本最小的路径延伸。这是默认设置。 `SHORTEST_PATH`—起点与终点之间距离最短的路径。此方法要求 `in_connection_points` 参数值中同时包含起点和终点。此路径将是突破局部水流阻碍的最短连线。 `MIN_ELEV`—线将沿着使高程变化最小的路径延伸。	String
max_length （可选）	溃口线允许的最大长度。如果某条潜在的溃口线超过此限制，将不会被包含在输出溃口线要素类中。默认值为 50 米或分析空间参考的地图单位的等效值。	Linear Unit

代码示例

GenerateBreachLines 示例 1（Python 窗口）

下面的示例演示了如何在 Python 窗口中使用此工具。此示例使用默认参数值生成挖掘洼地多边形、连接起点和终点连接点的最短距离线。

from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapy/examples/data"
GenerateBreachLines("inputDepressionPolygons.shp", "inputSurfaceRaster.tif", "C:/sapyexamples/output/streams.shp", "", "", "", "")

GenerateBreachLines 示例 2（独立脚本）

此示例生成挖掘洼地多边形且长度不超过 50 米的线，这些线遵循最小高程路径。

# Name: GenerateBreachLines_standalone.py
# Description: Generates lines that breach depression polygons following the 
#              minimum elevation path and a maximum length of 50 meters.
# Requirements: Spatial Analyst extension

# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *

# Set the analysis environments
env.workspace = "C:/sapyexamples/data"

# Set the local variables
in_depression_polygons = "depressions.shp",
in_surface_raster = "inSurfaceRaster.tif"
out_breach_lines = "C:/sapyexamples/output/breachlines.shp"
in_connection_points= None
trace_method = "MIN_BREACHING_COST"
max_length = "50 Meters"


# Run Generate Breach Lines
GenerateBreachLines(in_depression_polygons, 
                    in_surface_raster,
                    out_breach_lines,
                    in_connection_points,
                    trace_method,
                    max_length)

环境

范围, 掩膜, 自动提交, 当前工作空间, 默认输出 Z 值, 地理变换, M 分辨率, M 容差, 输出配置关键字, 输出坐标系, 输出包含 M 值, 输出包含 Z 值, 输出 M 值域, 输出 XY 值域, 输出 Z 值域, 临时工作空间, XY 分辨率, XY 容差, Z 分辨率, Z 容差

许可信息

基本: 需要 Spatial Analyst
标准: 需要 Spatial Analyst
高级: 需要 Spatial Analyst

参考

"Lindsay J, Dhun K. 2015. Modelling surface drainage patterns in altered landscapes using LiDAR. International Journal of Geographical Information Science, 29: 1-15. DOI: 10.1080/13658816.2014.975715"

生成溃口线 (Spatial Analyst 工具)

汇总

用法

参数

环境

许可信息

参考

相关主题