サーフェスの体積(Surface Volume) (3D Analyst)

ライセンス レベル:BasicStandardAdvanced

サマリ

指定した参照平面より上または下にあるラスタ、TIN、またはテレイン データセットのサーフェスの面積および体積を計算します。

[サーフェスの体積(Surface Volume)] ツールの仕組みの詳細

Surface Volume

使用法

構文

SurfaceVolume_3d (in_surface, {out_text_file}, {reference_plane}, {base_z}, {z_factor}, {pyramid_level_resolution})
パラメータ説明データ タイプ
in_surface

面積と体積の計算に使用する、入力ラスタ、TIN、またはテレイン データセットのサーフェス。

Raster Layer; Terrain Layer; TIN Layer
out_text_file
(オプション)

結果を含むオプションの出力テキスト ファイル。

File
reference_plane
(オプション)

指定した高さより上を計算するか、下を計算するかを選択します。

  • ABOVE体積と面積は、[平面の高さ] より上を計算します。これがデフォルトです。
  • BELOW体積と面積は、[平面の高さ] より下を計算します。
String
base_z
(オプション)

面積と体積の計算に使用される平面の標高。

Double
z_factor
(オプション)

サーフェスの体積を計算するために入力サーフェスの高さに乗算する係数。Z 座標の単位を X および Y 座標の単位に一致するように変換するために使用します。

Double
pyramid_level_resolution
(オプション)

ジオプロセシングに使用するテレイン データセットのピラミッド レベルの解像度。デフォルト値は 0(最大解像度)です。

Double

コードのサンプル

SurfaceVolume(サーフェスの体積)の例 1(Python ウィンドウ)

次のサンプルは、Python ウィンドウでこのツールを使用する方法を示しています。

import arcpy
from arcpy import env

arcpy.CheckOutExtension("3D")
env.workspace = "C:/data"
arcpy.SurfaceVolume_3d("sample.gdb/featuredataset/terrain", "surf_vol.txt", 
                      "ABOVE", 300, 1, 5)
SurfaceVolume(サーフェスの体積)の例 2(スタンドアロン スクリプト)

次のサンプルは、スタンドアロン Python スクリプトでこのツールを使用する方法を示しています。

'''****************************************************************************
Name: Surface Volume Example
Description: This script demonstrates how to use the 
             Surface Volume tool.
             
****************************************************************************'''
# Import system modules
import arcpy
from arcpy import env
import exceptions, sys, traceback

try:
    # Obtain a license for the ArcGIS 3D Analyst extension
    arcpy.CheckOutExtension("3D")
    # Set environment settings
    env.workspace = "C:/data"
    # Set Local Variables
    inSurface = "elevation_tin"
    #Execute SurfaceVolume
    result = arcpy.SurfaceVolume_3d(inSurface, "", "ABOVE", "300", "1", "5")
    print result.GetMessage(0)

except arcpy.ExecuteError:
    print arcpy.GetMessages()
except:
    # Get the traceback object
    tb = sys.exc_info()[2]
    tbinfo = traceback.format_tb(tb)[0]
    # Concatenate error information into message string
    pymsg = 'PYTHON ERRORS:\nTraceback info:\n{0}\nError Info:\n{1}'\
          .format(tbinfo, str(sys.exc_info()[1]))
    msgs = 'ArcPy ERRORS:\n {0}\n'.format(arcpy.GetMessages(2))
    # Return python error messages for script tool or Python Window
    arcpy.AddError(pymsg)
    arcpy.AddError(msgs)

環境

関連トピック

ライセンス情報

ArcGIS for Desktop Basic: 次のものが必要 3D Analyst
ArcGIS for Desktop Standard: 次のものが必要 3D Analyst
ArcGIS for Desktop Advanced: 次のものが必要 3D Analyst
9/14/2013