サーフェス差分 (3D Analyst ツール)
サマリー
2 つのサーフェス間の変位を計算し、1 つ目のサーフェスが 2 つ目のサーフェスの上にある、下にある、または同一であるエリアを特定します。
サーフェス差分の詳細
使用法
出力は、入力サーフェスの重なる部分だけを表します。
入力サーフェスと参照サーフェス間の Z 差分を評価する場合は、出力ラスターまたは TIN の生成を検討してください。
2 つの入力サーフェスの水平座標系と鉛直座標系がそれぞれ同一である場合が最も効果的です。
出力フィーチャクラスには、入力サーフェスの領域が参照平面の上にあるか、下にあるか、同一であるかによって入力サーフェスの領域を分割するポリゴン フィーチャが含まれます。 フィーチャの属性テーブルには、次のフィールドが含まれます。
Volume—ポリゴンで囲まれた入力サーフェスと参照サーフェス間の空間の体積。 2 つのサーフェスが同一であるエリアでは、体積は常に 0 になります。
SArea—ポリゴンで囲まれた入力サーフェスの表面積。
Code—サーフェスと参照平面の空間リレーションシップを示す数値。 -1 はサーフェスが参照平面の下にあること、0 はサーフェスが参照平面と同一であること、1 はサーフェスが参照平面の上にあることを示します。
パラメーター
ラベル
説明
データ タイプ
入力サーフェス
参照サーフェスから相対変位が評価されるトライアングル サーフェス。
LAS Dataset Layer; Terrain Layer; TIN Layer
参照サーフェス
入力サーフェスの相対変位を特定するためのベースラインとして使用されるトライアングル サーフェス。
LAS Dataset Layer; Terrain Layer; TIN Layer
出力フィーチャクラス
同じ分類に属し、ポリゴンにグループ化された隣接する三角形および三角形パーツを含む出力フィーチャクラス。 各リージョンの差分に囲まれる体積は、属性テーブルに示されます。
Feature Class
解析解像度
(オプション)
入力サーフェスの生成に使用される解像度。 テレイン データセットの場合、この値はピラミッド レベルの定義に対応し、デフォルト値 0 が最大解像度を表します。 LAS データセットの場合、この値は LAS ポイントのリターンを間引くために使用する正方形領域の各辺の長さを表しています。
Double
参照解析解像度
(オプション)
参照サーフェスの生成に使用される解像度。 テレイン データセットの場合、この値はピラミッド レベルの定義に対応し、デフォルト値 0 が最大解像度を表します。 LAS データセットの場合、この値は LAS ポイントのリターンを間引くために使用する正方形領域の各辺の長さを表しています。
Double
出力ラスター
(オプション)
参照サーフェスに対して正規化された入力サーフェスを表す値を持つ、出力ラスター サーフェス。 正の値は、入力サーフェスが参照サーフェスの上にあるエリアを表し、負の値は、入力サーフェスが参照サーフェスの下にあるエリアを表します。 ラスターの値はリニア内挿法を使用して TIN から取得されます。
Raster Dataset
ラスター セル サイズ
(オプション)
出力ラスターのセル サイズ。
Double
出力 TIN フォルダー
(オプション)
入力サーフェスと参照サーフェス間の差分を表す値を持つ、1 つ以上の TIN サーフェスを格納するためのフォルダーの場所。
Folder
出力 TIN ベース名
(オプション)
各出力 TIN サーフェスのベース名。 データを表すのに 1 つの 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
(オプション)
入力サーフェスの生成に使用される解像度。 テレイン データセットの場合、この値はピラミッド レベルの定義に対応し、デフォルト値 0 が最大解像度を表します。 LAS データセットの場合、この値は LAS ポイントのリターンを間引くために使用する正方形領域の各辺の長さを表しています。
Double
reference_pyramid_level_resolution
(オプション)
参照サーフェスの生成に使用される解像度。 テレイン データセットの場合、この値はピラミッド レベルの定義に対応し、デフォルト値 0 が最大解像度を表します。 LAS データセットの場合、この値は LAS ポイントのリターンを間引くために使用する正方形領域の各辺の長さを表しています。
Double
out_raster
(オプション)
参照サーフェスに対して正規化された入力サーフェスを表す値を持つ、出力ラスター サーフェス。 正の値は、入力サーフェスが参照サーフェスの上にあるエリアを表し、負の値は、入力サーフェスが参照サーフェスの下にあるエリアを表します。 ラスターの値はリニア内挿法を使用して TIN から取得されます。
Raster Dataset
raster_cell_size
(オプション)
出力ラスターのセル サイズ。
Double
out_tin_folder
(オプション)
入力サーフェスと参照サーフェス間の差分を表す値を持つ、1 つ以上の TIN サーフェスを格納するためのフォルダーの場所。
Folder
out_tin_basename
(オプション)
各出力 TIN サーフェスのベース名。 データを表すのに 1 つの 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 ドメイン , 出力データのコンフィグレーション キーワード , 自動コミット , テレインの解析におけるメモリー使用を最小化
ライセンス情報
Basic: 3D Analyst が必要
Standard: 3D Analyst が必要
Advanced: 3D Analyst が必要