表面体积 (3D Analyst 工具)

汇总

计算表面和参考平面之间区域的面积和体积。

插图

表面体积工具图示

用法

当表面 z 值不使用 x,y 单位而使用其他测量单位时，使用 Z 因子参数可确保体积计算的准确性。 Z 因子参数不会修改原始数据。工具将自动在定义 x,y 和 z 坐标系时确定适用的 Z 因子。

输出文本文件将存储表面的完整路径、用于生成结果的参数以及计算得出的面积和体积测量值。如果在工具的多次运行中指定了相同的输出文件，则会维护预先存在的记录并将结果追加至表，如下面的示例所示：


数据集	平面高度	参考	Z 因子	2D 面积	3D 面积	卷
C:\data\tin	100.00	上方	1	15984467.82	16354331.40	1886012931.05
C:\data\raster.tif	250.5	下方	3.28084	0	0	0
C:\data.gdb\fd\terrain	1250	上方	0.3048	1854238.36	1970550.88	1099221466.89

当计算区域为非矩形范围时，请使用面来定义此区域。然后使用 面体积 工具来确定计算结果。
将使用每个像元中心点的范围评估栅格表面，不使用整个像元区域的范围。相对于为栅格显示的数据区域，生成的分析会将栅格的数据区域减少半个像元。

标注	说明	数据类型
输入表面	要处理的栅格、TIN 或 terrain 表面。	Mosaic Layer; Raster Layer; Terrain Layer; TIN Layer
输出文本文件（可选）	包含面积和体积计算的以逗号分隔的 ASCII 文本文件。如果该文件已经存在，结果将会追加至该文件。	File
参考平面（可选）	指定将用于计算结果的参考平面的方向。 Above the Plane—Volume and area calculations will represent the region of space between the specified plane height and the portions of the surface that are above the plane. This is the default. Below the Plane—Volume and area calculations will represent the region of space between the specified plane height and the portions of the surface that are below the plane.	String
平面高度（可选）	将用于计算面积和体积的平面的 z 值。	Double
Z 因子（可选）	Z 值将乘上的系数。此值通常用于转换 z 线性单位来匹配 x,y 线性单位。默认值为 1，此时高程值保持不变。如果输入表面的空间参考具有已指定线性单位的 z 基准面，则此参数不可用。	Double
金字塔等级分辨率（可选）	将使用 terrain 金字塔等级的 z 容差或窗口大小分辨率。默认值为 0，或全分辨率。	Double

arcpy.3d.SurfaceVolume(in_surface, {out_text_file}, {reference_plane}, {base_z}, {z_factor}, {pyramid_level_resolution})

名称	说明	数据类型
in_surface	要处理的栅格、TIN 或 terrain 表面。	Mosaic Layer; Raster Layer; Terrain Layer; TIN Layer
out_text_file （可选）	包含面积和体积计算的以逗号分隔的 ASCII 文本文件。如果该文件已经存在，结果将会追加至该文件。	File
reference_plane （可选）	指定将用于计算结果的参考平面的方向。 `ABOVE`—Volume and area calculations will represent the region of space between the specified plane height and the portions of the surface that are above the plane. This is the default. `BELOW`—Volume and area calculations will represent the region of space between the specified plane height and the portions of the surface that are below the plane.	String
base_z （可选）	将用于计算面积和体积的平面的 z 值。	Double
z_factor （可选）	Z 值将乘上的系数。此值通常用于转换 z 线性单位来匹配 x,y 线性单位。默认值为 1，此时高程值保持不变。如果输入表面的空间参考具有已指定线性单位的 z 基准面，则此参数不可用。	Double
pyramid_level_resolution （可选）	将使用 terrain 金字塔等级的 z 容差或窗口大小分辨率。默认值为 0，或全分辨率。	Double

代码示例

SurfaceVolume 示例 1（Python 窗口）

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

arcpy.env.workspace = "C:/data"
arcpy.ddd.SurfaceVolume("sample.gdb/featuredataset/terrain", "surf_vol.txt",
                       reference_plane="ABOVE", base_z=300, z_factor=3.24,
                       pyramid_level_resolution=5)

SurfaceVolume 示例 2（独立脚本）

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

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

****************************************************************************'''
# Import system modules
import arcpy

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

# Set Local Variables
inSurface = "elevation_tin"

# Run SurfaceVolume
result = arcpy.ddd.SurfaceVolume(inSurface, "", "ABOVE", "300", "1", "5")
print(result.getMessages())

环境

当前工作空间

许可信息

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

表面体积 (3D Analyst 工具)

汇总

插图

用法

参数

环境

许可信息

相关主题