依据文件实现地形转栅格 (空间分析)

许可等级:BasicStandardAdvanced

摘要

通过文件中指定的参数将点、线和面数据插值成符合真实地表的栅格表面。

了解有关地形转栅格工具工作原理的详细信息

用法

语法

TopoToRasterByFile (in_parameter_file, {out_stream_features}, {out_sink_features}, {out_residual_feature}, {out_stream_cliff_error_feature}, {out_contour_error_feature})
参数说明数据类型
in_parameter_file

包含插值中所用输入和参数的待输入 ASCII 文本文件。

通常,此文件在上次运行地形转栅格时创建,同时还将指定可选的输出参数文件。

为了测试参数更改的结果,对此文件进行编辑并重新运行插值比每次正确地启用地形转栅格工具更容易。

File
out_stream_features
(可选)

河流折线要素的输出要素类。

拆线要素按如下方式编码:

  1. 不在悬崖上的输入河流线。
  2. 在悬崖上的输入河流线(瀑布)。
  3. 清除伪汇的地形强化。
  4. 从等值线拐角确定的河流线。
  5. 从等值线拐角确定的山脊线。
  6. 未使用代码。
  7. 数据河流线边条件。
  8. 未使用代码。
  9. 表示大型高程数据间隙的线。
Feature Class
out_sink_features
(可选)

其余汇点要素的输出要素类。

Feature Class
out_residual_feature
(可选)

由局部离散误差进行衡量的所有大高程残差的输出点要素类。

应对所有大于 10 的比例缩放残差进行检查,查看输入高程和河流数据是否存在错误。大比例缩放残差表示输入高程数据和河流线数据之间存在冲突。这可能也与不良的自动地形强化有关。这些冲突可以通过在首次检查和纠正现有输入数据中的错误后提供附加的流线和/或点高程数据来进行修复。未大比例缩放的残差通常表示存在输入高程误差。

Feature Class
out_stream_cliff_error_feature
(可选)

可能出现河流和悬崖错误的位置的输出点要素类。

可从点要素类来识别其河流有闭合环、支流和悬崖上河流的位置。还可识别相邻像元与悬崖高低边不一致的的悬崖。这可以理想地指出方向错误的悬崖。

点按如下方式编码:

  1. 数据河流线网络中的真回路。
  2. 以外栅格编码的河流网络中的回路。
  3. 通过连接湖泊的河流网络中的回路。
  4. 支流点。
  5. 悬崖上的河流(瀑布)。
  6. 表示从湖泊流出多条河流的点。
  7. 未使用代码。
  8. 悬崖旁高度与悬崖方向不一致的点。
  9. 未使用代码。
  10. 已移除圆形支流。
  11. 无流入河流的支流。
  12. 不同于出现数据河流线支流位置的输出像元中的栅格化支流。
  13. 处理边条件时出错 - 非常复杂的河流线数据的指示符。
Feature Class
out_contour_error_feature
(可选)

可能发生的与输入等值线数据相关的错误的输出点要素类。

高度偏差达到输出栅格所示等值线值标准偏差五倍以上的等值线会报告至此要素类。与不同高程值的等值线相连接的等值线在此要素类中会使用代码 1 进行标记,这是等值线标注错误的明确标志。

Feature Class

返回值

名称说明数据类型
out_surface_raster

输出插值后的表面栅格。

Raster

代码实例

依据文件实现地形转栅格 (TopoToRasterByFile) 示例 1(Python 窗口)

该示例根据定义输入点、线和面数据的参数文件创建符合真实地表的 TIFF 表面栅格。

import arcpy
from arcpy import env  
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outTTRByFile = TopoToRasterByFile("topotorasterbyfile.txt", 
                   "C:/sapyexamples/output/out_streams.shp", "#",
                   "C:/sapyexamples/output/out_resids.shp")
outTTRByFile.save("C:/sapyexamples/output/ttrbyfout.tif")
依据文件实现地形转栅格 (TopoToRasterByFile) 示例 2(独立脚本)

该示例根据定义输入点、线和面数据的参数文件创建符合真实地表的 Grid 表面栅格。

# Name: TopoToRasterByFile_Ex_02.py
# Description: Interpolates a hydrologically correct 
#    surface from point, line, and polygon data using
#    parameters specified in a file.
# Requirements: Spatial Analyst Extension

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

# Set environment settings
env.workspace = "C:/sapyexamples/data"

# Set local variables
inParameterFile = "topotorasterbyfile.txt"

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

# Execute TopoToRasterByFile
outTTRByFile = TopoToRasterByFile(inParameterFile, "#", "C:/sapyexamples/output/out_resids2.shp")

# Save the output 
outTTRByFile.save("C:/sapyexamples/output/ttrbyfout02")

环境

相关主题

许可信息

ArcGIS for Desktop Basic:需要 Spatial Analyst 或 3D Analyst
ArcGIS for Desktop Standard:需要 Spatial Analyst 或 3D Analyst
ArcGIS for Desktop Advanced:需要 Spatial Analyst 或 3D Analyst
9/15/2013