填挖方 (空间分析)

摘要

计算两表面间体积的变化。通常用于执行填挖操作。

了解有关填挖方工具工作原理的详细信息

插图

Cut Fill illustration
OutRas = CutFill(Before_Ras, After_Ras)
Cut Fill fields illustration
When the Cut Fill operation is performed, by default, a specialized renderer is applied to the layer that highlights the locations of cut and of fill. The determinant is in the attribute table of the output raster, which considers positive volume to be where material was cut (removed), and negative volume where material was filled (added).

用法

语法

CutFill (in_before_surface, in_after_surface, {z_factor})
参数说明数据类型
in_before_surface

表示填/挖操作之前的表面的输入。

Raster Layer
in_after_surface

表示填/挖操作之后的表面的输入。

Raster Layer
z_factor
(可选)

一个表面 z 单位中地面 x,y 单位的数量。

z 单位与输入表面的 x,y 单位不同时,可使用 z 因子调整 z 单位的测量单位。计算最终输出表面时,将用 z 因子乘以输入表面的 z 值。

如果 x,y 单位和 z 单位采用相同的测量单位;则 z 因子为 1。这是默认值。

如果 x,y 单位和 z 单位采用不同的测量单位,则必须将 z 因子设置为适当的因子,否则会得到错误的结果。例如,如果 z 单位是英尺而 x,y 单位是米,则应使用 z 因子 0.3048 将 z 单位从英尺转换为米(1 英尺 = 0.3048 米)。

Double

返回值

名称说明数据类型
out_raster

定义挖填区域的输出栅格。

这些值显示了已向表面添加或从表面移除的位置和数量。

Raster

代码示例

挖填示例 1(Python 窗口)

在本例中将计算出填挖操作位置处的体积和面积,并将结果输出为 Grid 栅格。

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outCutFill = CutFill("elevation01", "elevation02", 1)
outCutFill.save("C:/sapyexamples/output/outcutfill01")
挖填示例 2(独立脚本)

在本例中将计算出填挖操作位置处的体积和面积,并将结果输出为 Grid 栅格。

# Name: Cutfill_Ex_02.py
# Description: Calculates the volume and area of cut and 
#              fill locations.
# 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
inBeforeRaster = "elevation01"
inAfterRaster =  "elevation02"
zFactor = 0.5

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

# Execute CutFill
outCutFill = CutFill(inBeforeRaster, inAfterRaster, zFactor)

# Save the output 
outCutFill.save("C:/sapyexamples/output/outcutfill02")

环境

相关主题

许可信息

ArcView: 需要 Spatial Analyst 或 3D Analyst
ArcEditor: 需要 Spatial Analyst 或 3D Analyst
ArcInfo: 需要 Spatial Analyst 或 3D Analyst

7/10/2012