定位洼地 (Spatial Analyst 工具)

汇总

根据空间特征，定位地形上低于周边区域的地表凹陷区域。

了解有关定位洼地工作原理的详细信息

用法

• 输入表面栅格（Python 中的 in_surface_raster）参数值可以为数字高程模型 (DEM)。 在算法内部，将基于已填充 DEM 与原始 DEM 之间的差值来标识洼地。

• 仅符合可选分析参数设置的所有要求的洼地才会包含在输出洼地面（Python 中的 out_depressions_polygons）参数值中。

• 输出连接点（Python 中的 out_connection_points）参数值包含了输出洼地面参数值中涉及的所有洼地的最低高程点。

  如果为与连接的最大距离（Python 中的 max_connection_distance）参数指定了值，则输出连接点还将包含每个洼地的下游连接点。

• 指定 Z 单位（Python 中的 z_unit）参数值可确保正确计算洼地深度。

  如果 z 单位可用于输入表面栅格的垂直坐标系，则将自动应用 z 单位。 如果缺失，建议您定义输入栅格的 z 单位。 可使用定义投影工具来指定 z 单位。 如果未指定任何值，则将默认使用“米”。

• 与连接的最大距离参数将下游连接定义为，在洼地范围内找到的高程低于最低高程像元的最近像元。 如果多个像元符合这些条件，则将返回找到的第一个像元。

• 仅当指定输入栅格或要素道路（Python 中的 in_road_data）参数时，才能应用与道路的最大距离（Python 中的 max_road_distance）参数。

• 输入表面栅格参数值的空间参考的地图单位用于填充最小面积、与连接的最大距离和与道路的最大距离参数的默认单位。 如果输入表面栅格参数值标识的单位与可用面积单位和线性单位均不匹配，则参数将分别默认为平方米和米。

• 该工具支持并行处理。 如果您的计算机具有多个处理器或处理器具有多个内核，则会获得更好的性能，特别是处理较大数据集时。 使用 Spatial Analyst 进行并行处理帮助主题包括有关此功能及其配置方法的详细信息。

  默认情况下，此工具将最多使用 50% 可用内核。 您可以通过并行处理因子环境来控制该工具使用的内核数。

• 有关适用于此工具的地理处理环境的详细信息，请参阅分析环境和 Spatial Analyst。

参数

• Dialog
• Python

标注	说明	数据类型
输入表面栅格	输入表面栅格。	Raster Layer
输出洼地面	将包含已识别洼地的输出要素类。 每个洼地面将具有唯一编号。 属性表中的其他字段用于存储有关洼地的特定信息。 这些字段包括： AREA—洼地的面积（以平方米为单位）。 VOLUME—洼地的体积（以立方米为单位）。 DIST_CON—与下游连接点的距离（以米为单位）。 只有在指定与连接的最大距离参数值的情况下，才会创建此字段。 DIST_ROAD—与最近道路的距离（以米为单位）。 仅当为可选输入道路数据参数指定数据集时，才会创建此字段。	Feature Class
输入栅格或要素道路 （可选）	用于定义道路的可选栅格或要素数据集。 可通过整型栅格或浮点型栅格，或通过点、线或面要素来定义道路。	Raster Layer; Feature Layer
输出连接点 （可选）	用于定义洼地中最低高程点和相应下游连接点的可选输出点。 下游连接定义为高程低于洼地内最低高程像元的最近像元。 只有在指定与连接的最大距离参数值的情况下，输出中才会包含下游连接点和相关字段。 每个点将具有唯一编号。 属性表中的其他字段用于存储有关点的特定信息。 这些字段包括： DEP_ID—与点相关联的洼地的标识符。 POINT_TYPE—用于指定点是洼地中的最低高程点 (= 0)，还是下游连接点 (= 1)。 POINT_ELEV—点的高程。 DIST_EDGE—与洼地的边的距离（以米为单位）。 DIST_POINT—与相应点的距离（以米为单位）。	Feature Class
深度下限 （可选）	洼地允许的深度下限。 最大深度小于此值的洼地将不会包含在最终输出中。 默认值为 0.05 米或者指定 z 单位的等效值。	Linear Unit
Z 单位 （可选）	指定将用于垂直 z 值的线性单位。 由垂直坐标系（如果存在）定义。 如果垂直坐标系不存在，则应使用单位列表来定义 z 单位，以确保测地线计算正确。 默认单位为米。 英寸—线性单位将为英寸。 英尺—线性单位将为英尺。 美国英尺—线性单位将为美国测量英尺。 码—线性单位将为码。 英里（美制）—线性单位将为美国测量英里。 海里—线性单位将为海里。 毫米—线性单位将为毫米。 厘米—线性单位将为厘米。 米—线性单位将为米。 千米—线性单位将为公里。 分米—线性单位将为分米。	String
最小面积 （可选）	洼地允许的最小面积。 面积是指洼地顶部的表面积。 面积小于此值的洼地将不会包含在最终输出中。 默认值为三个栅格像元的总面积，或者采用输入表面栅格参数值的空间参考的平方地图单位的等效值。	Areal Unit
与连接的最大距离 （可选）	从洼地的边到下游连接点允许的最大距离。 下游连接定义为高程低于洼地内最低高程像元的最近像元。 如果与下游连接的距离大于此值，则洼地将不会包含在最终输出中。 仅当为此参数指定了值时，才会应用该参数。	Linear Unit
与道路的最大距离 （可选）	从洼地的边到最近道路允许的最大距离。 如果洼地与道路的距离大于此值，则不会将其包含在最终输出中。 仅当提供输入栅格或要素道路参数的值时，该参数才可用。 默认值为 30 米，或者采用输入表面栅格参数值的空间参考的地图单位的等效值。	Linear Unit

环境

自动提交, 像元大小, 像元大小投影方法, 当前工作空间, 地理变换, 掩膜, 输出配置关键字, 输出坐标系, 范围, 并行处理因子, 临时工作空间, 捕捉栅格

许可信息

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

相关主题

• 水文分析工具集概述
• 生成溃口线
• 调整栅格以匹配流
• 查找地理处理工具