表面差异 (3D Analyst 工具)

汇总

计算两个表面之间的位移来确定哪个表面在上、哪个表面在下或两个表面位置相同。

用法

该输出仅表示输入表面的重叠部分。
要评估输入和参考表面之间的 Z 值差异，请考虑生成输出栅格或 TIN。
输入表面的水平和垂直坐标系最好相同。
输出要素类将拥有按输入表面区域在上、在下或与参考平面相同来对其进行划分的面要素。要素属性表将包含以下字段：
- Volume—由面限定边界的输入表面与参考表面之间的空间体积。两个表面相同的区域的体积始终为 0。
- SArea—以面为界的输入表面的表面积。
- Code—用于描述表面与参考平面空间关系的数字值。 -1 表示表面在参考平面以下，0 表示表面与参考平面重合，1 表示表面在参考平面之上。

标注	说明	数据类型
输入表面	从参考表面评估其相对位移的三角化网格面。	LAS Dataset Layer; Terrain Layer; TIN Layer
参考表面	将作为基线用于确定输入表面相对位移的三角化网格面。	LAS Dataset Layer; Terrain Layer; TIN Layer
输出要素类	包含了因分类相同而划分为面的连续三角形和三角面部件的输出要素类。每个差异区域包围的体积均列于属性表中。	Feature Class
分析分辨率（可选）	将用于生成输入表面的分辨率。对于 terrain 数据集，此分辨率与其金字塔等级定义对应，其中默认值 0 表示全分辨率。对于 LAS 数据集，此值表示用于稀疏化 LAS 点回波的方形区域各边的长度。	Double
参考分析分辨率（可选）	将用于生成参考表面的分辨率。对于 terrain 数据集，此分辨率与其金字塔等级定义对应，其中默认值 0 表示全分辨率。对于 LAS 数据集，此值表示用于稀疏化 LAS 点回波的方形区域各边的长度。	Double
输出栅格（可选）	其值代表对参考表面进行归一化的输入表面的输出栅格表面。正值反映输入表面位于参考表面之上的区域，而负值表示输入表面位于参考表面之下的区域。使用线性插值法从 TIN 获取栅格值。	Raster Dataset
栅格像元大小（可选）	输出栅格的像元大小。	Double
输出 TIN 文件夹（可选）	存储其值代表输入和参考表面之间差异的一个或多个 TIN 表面的文件夹位置。	Folder
输出 TIN 基本名称（可选）	指定给每个输出 TIN 表面的基本名称。如果一个 TIN 数据不足以表示数据，则会创建多个具有相同基本名称的 TIN。	String
LAS 稀疏化方法	在应用某一分析分辨率来稀疏化输入 LAS 数据集表面时，在每个分析窗口中选择 LAS 点所使用的方法。所生成的点将用于构建三角化网格面。 Closest to mean—The LAS point whose value is closest to the mean of all LAS points in the analysis window will be used. This is the default. Minimum—The LAS point with the smallest z-value among all the LAS points in the analysis window. Maximum—The LAS point with the highest z-value among all the LAS points in the analysis window.	String
参考 LAS 稀疏化方法	在应用某一分析分辨率来稀疏化输入 LAS 数据集表面时，在每个分析窗口中选择 LAS 点所使用的方法。所生成的点将用于构建三角化网格面。 Closest to mean—The LAS point whose value is closest to the mean of all LAS points in the analysis window will be used. This is the default. Minimum—The LAS point with the smallest z-value among all the LAS points in the analysis window. Maximum—The LAS point with the highest z-value among all the LAS points in the analysis window.	String
处理范围（可选）	将评估的数据范围。当前显示范围 - 范围基于活动地图或场景。绘制范围 - 范围将基于在地图或场景上绘制的矩形。图层范围 - 范围基于活动地图图层。选择可用图层或者使用所有图层中的数据范围选项。每个地图图层具有以下选项：所有要素 - 所有要素的范围。选定要素 - 选定要素的范围。可见要素 - 可见要素的范围。浏览 - 范围将基于数据集。输入的交集 - 范围将为所有输入的相交范围。输入的并集 - 范围将为所有输入的合并范围。剪贴板 - 可在剪贴板中复制和粘贴范围。复制范围 - 将范围坐标和坐标系复制到剪贴板。粘贴范围 - 从剪贴板粘贴范围和坐标系。如果剪贴板不包含坐标系，则范围将使用地图的坐标系。重置范围 - 将范围重置为默认值。当手动提供坐标时，坐标必须为数值，并且位于活动地图的坐标系中。地图可能使用与提供的坐标不同的显示单位。在南纬和西经坐标中使用负号。	Extent
处理边界	将定义待处理区域的一个或多个面要素。	Feature Layer

arcpy.3d.SurfaceDifference(in_surface, in_reference_surface, out_feature_class, {pyramid_level_resolution}, {reference_pyramid_level_resolution}, {out_raster}, {raster_cell_size}, {out_tin_folder}, {out_tin_basename}, method, reference_method, {extent}, boundary)

名称	说明	数据类型
in_surface	从参考表面评估其相对位移的三角化网格面。	LAS Dataset Layer; Terrain Layer; TIN Layer
in_reference_surface	将作为基线用于确定输入表面相对位移的三角化网格面。	LAS Dataset Layer; Terrain Layer; TIN Layer
out_feature_class	包含了因分类相同而划分为面的连续三角形和三角面部件的输出要素类。每个差异区域包围的体积均列于属性表中。	Feature Class
pyramid_level_resolution （可选）	将用于生成输入表面的分辨率。对于 terrain 数据集，此分辨率与其金字塔等级定义对应，其中默认值 0 表示全分辨率。对于 LAS 数据集，此值表示用于稀疏化 LAS 点回波的方形区域各边的长度。	Double
reference_pyramid_level_resolution （可选）	将用于生成参考表面的分辨率。对于 terrain 数据集，此分辨率与其金字塔等级定义对应，其中默认值 0 表示全分辨率。对于 LAS 数据集，此值表示用于稀疏化 LAS 点回波的方形区域各边的长度。	Double
out_raster （可选）	其值代表对参考表面进行归一化的输入表面的输出栅格表面。正值反映输入表面位于参考表面之上的区域，而负值表示输入表面位于参考表面之下的区域。使用线性插值法从 TIN 获取栅格值。	Raster Dataset
raster_cell_size （可选）	输出栅格的像元大小。	Double
out_tin_folder （可选）	存储其值代表输入和参考表面之间差异的一个或多个 TIN 表面的文件夹位置。	Folder
out_tin_basename （可选）	指定给每个输出 TIN 表面的基本名称。如果一个 TIN 数据不足以表示数据，则会创建多个具有相同基本名称的 TIN。	String
method	在应用某一分析分辨率来稀疏化输入 LAS 数据集表面时，在每个分析窗口中选择 LAS 点所使用的方法。所生成的点将用于构建三角化网格面。 `CLOSEST_TO_MEAN`—The LAS point whose value is closest to the mean of all LAS points in the analysis window will be used. This is the default. `MIN`—The LAS point with the smallest z-value among all the LAS points in the analysis window. `MAX`—The LAS point with the highest z-value among all the LAS points in the analysis window.	String
reference_method	在应用某一分析分辨率来稀疏化输入 LAS 数据集表面时，在每个分析窗口中选择 LAS 点所使用的方法。所生成的点将用于构建三角化网格面。 `CLOSEST_TO_MEAN`—The LAS point whose value is closest to the mean of all LAS points in the analysis window will be used. This is the default. `MIN`—The LAS point with the smallest z-value among all the LAS points in the analysis window. `MAX`—The LAS point with the highest z-value among all the LAS points in the analysis window.	String
extent （可选）	将评估的数据范围。 `MAXOF` - 将使用的所有输入的最大范围。 `MINOF` - 将使用的所有输入共用的最小范围。 `DISPLAY` - 范围与可见显示范围相等。图层名称 - 将使用指定图层的范围。 `Extent` 对象 - 将使用指定对象的范围。以空格分隔的坐标字符串 - 将使用指定字符串的范围。坐标按 x-min、y-min、x-max、y-max 的顺序表示。	Extent
boundary	将定义待处理区域的一个或多个面要素。	Feature Layer

代码示例

SurfaceDifference 示例 1（Python 窗口）

下面的示例演示了如何在 Python 窗口中使用此工具：

arcpy.env.workspace = "C:/data"
arcpy.ddd.SurfaceDifference("sample.gdb/lidar/terrain", "flood_tin", "surface_diff.shp")

SurfaceDifference 示例 2（独立脚本）

下面的示例演示了如何在独立 Python 脚本中使用此工具：

'''****************************************************************************
Name: SurfaceDifference Example
Description: This script demonstrates how to use the
             SurfaceDifference tool.
****************************************************************************'''

# Import system modules
import arcpy

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

# Set Local Variables
inSurface = "flood_tin"
inReference = "elev_tin"

# Ensure output name is unique
outPoly = arcpy.CreateUniqueName("difference.shp")

# Run SurfaceDifference
arcpy.ddd.SurfaceDifference(inSurface, inReference, outPoly)

环境

当前工作空间, 范围, 输出坐标系, 地理变换, XY 分辨率, XY 容差, 输出 XY 值域, 输出配置关键字, 自动提交, 对 terrain 进行分析时使所用内存最小

许可信息

基本: 需要 3D Analyst
标准: 需要 3D Analyst
高级: 需要 3D Analyst

表面差异 (3D Analyst 工具)

汇总

用法

参数

环境

许可信息

相关主题