切り盛り(Cut Fill) (Spatial Analyst)

ライセンス レベル:BasicStandardAdvanced

サマリ

2 つのサーフェスの容量の変化を計算します。通常は、切り盛り操作に使用します。

切り盛りの仕組みに関する詳細

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 係数が適切でないと、正しい結果が得られません。たとえば、Z 単位がフィートであり、X、Y 単位がメートルの場合、Z 係数 0.3048 を使用して Z 単位をフィートからメートルへ変換します(1 フィート = 0.3048 メートル)。

Double

戻り値

名前説明データ タイプ
out_raster

切り盛りリージョンを定義する出力ラスタ。

値は、サーフェスを追加または除外する位置と量を示します。

Raster

コードのサンプル

CutFill(切り盛り)の例 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")
CutFill(切り盛り)の例 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")

環境

関連トピック

ライセンス情報

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/17/2013