概要
減算フィーチャクラス内にあるマルチパッチ フィーチャの囲まれたボリュームと重なり合う、ターゲット フィーチャクラス内のマルチパッチ フィーチャの部分を削除します。
図
使用法
-
この解析には、クローズド マルチパッチ ジオメトリが必要です。[クローズド 3D (Is Closed 3D)] ツールを使用すると、マルチパッチ フィーチャクラスにクローズド フィーチャが含まれているかどうかを判定できます。また、[クローズド マルチパッチの作成 (Enclose Multipatch)] ツールを使用すると、マルチパッチ フィーチャのギャップを除去できます。
減算フィーチャに完全に囲まれた入力フィーチャは、出力から完全に削除されます。
このツールの実行には非常に時間がかかるので、適切な入力データセットを選択してください。
出力フィーチャには、入力フィーチャのどの属性も含まれません。必要ならば、ソース フィーチャへの空間結合またはオプションの出力テーブルへのリレーションシップ クラスを構築して、入力フィーチャから出力データセットに属性をマップすることができます。
このツールは、3D フィーチャの解析機能を備えた 3D セット演算子です。セット演算子の種類と、その使用方法については、「3D セット演算子の使用」をご参照ください。
構文
arcpy.ddd.Difference3D(in_features_minuend, in_features_subtrahend, out_feature_class, {out_table})| パラメーター | 説明 | データ タイプ |
in_features_minuend | 減算フィーチャによって削除されるフィーチャを持つマルチパッチ フィーチャ | Feature Layer |
in_features_subtrahend | 入力から差し引かれるマルチパッチ フィーチャ | Feature Layer |
out_feature_class | 結果のフィーチャを含む出力マルチパッチ フィーチャクラス | Feature Class |
out_table (オプション) | 入力フィーチャと差分出力との間のリレーションシップに関する情報を格納するオプションのテーブルこのテーブルには、次のフィールドが存在しています。
| Table |
コードのサンプル
Difference3D (ディファレンス 3D) の例 1 (Python ウィンドウ)
次のサンプルは、Python ウィンドウでこのツールを使用する方法を示しています。
import arcpy
from arcpy import env
arcpy.CheckOutExtension('3D')
env.workspace = 'C:/data'
arcpy.Difference3D_3d('input_mp.shp', 'erase_mp.shp', 'difference_mp.shp')
Difference3D (ディファレンス 3D) の例 2 (スタンドアロン スクリプト)
次のサンプルは、スタンドアロン Python スクリプトでこのツールを使用する方法を示しています。
'''****************************************************************************
Name: Difference3D Example
Description: This script demonstrates how to create
shadow volumes that fall along a specified surface using the
Difference3D tool.
****************************************************************************'''
# Import system modules
import arcpy
import exceptions, sys, traceback
from arcpy import env
try:
# Obtain a license for the ArcGIS 3D Analyst extension
arcpy.CheckOutExtension('3D')
# Set environment settings
env.workspace = 'C:/data'
# Set Local Variables
inMP = 'buildings.shp'
eraseMP = 'bldg_extensions.shp'
outMP = arcpy.CreateUniqueName('bldgs_without_extensions.shp')
# Execute Difference3D
arcpy.Difference3D_3d(inMP, eraseMP, outMP)
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)
環境
ライセンス情報
- Basic: 次のものが必要 3D Analyst
- Standard: 次のものが必要 3D Analyst
- Advanced: 次のものが必要 3D Analyst