ユニオン 3D（Union 3D） (3D Analyst)
サマリ
重なっているマルチパッチでパッチのジオメトリック交点を計算し、これらのマルチパッチを集約します。出力として作成されるフィーチャの数は、ツールの設定によって決まります。
使用法
-
入力フィーチャクラスまたはレイヤには、マルチパッチ ジオメトリが必要です。
-
閉じたマルチパッチのみが処理されます。その他のマルチパッチはすべてスキップされ、ジオプロセシングのログにエラーが書き込まれます。[クローズド 3D（Is Closed 3D）] ジオプロセシング ツールを使用して、閉じていないフィーチャがあるかを確認できます。
-
[ユニオン 3D（Union 3D）] では、出力フィーチャクラスに非常に大きく複雑なフィーチャが作成される場合があります。これらのフィーチャでは、表示の問題が発生したり、表示したときのパフォーマンスが低下する可能性があります。集約するフィーチャの数を決定するときに注意してください。
-
出力フィーチャクラスには、入力フィーチャクラスの属性はいずれも設定されません。オプションのテーブルを作成して、どのフィーチャを結合したか、および結合した新しいフィーチャをどこに作成したかを記録することができます。
[ユニオン 3D（Union 3D）] は、[3D フィーチャ] ツールセットに含まれる 3D セット演算子です。セット演算子の種類と、その使用方法については、「3D セット演算子の使用」をご参照ください。
構文
| パラメータ | 説明 | データ タイプ |
in_feature_class |
インターセクトおよび集約する閉じたマルチパッチ フィーチャ。 | Features |
group_field （オプション） |
集約する入力マルチパッチ フィーチャのグループ化に使用するフィールド。 | Field |
out_feature_class |
集約したマルチパッチを格納するマルチパッチ フィーチャクラス。 | Feature Class |
out_table （オプション） |
入力フィーチャと、これらを集約した結果の出力フィーチャを表す、多対 1 のテーブル。 | Table |
disable_optimization （オプション） |
重なるマルチパッチ フィーチャを自動的に判断する最適化を無効にし、重なっているフィーチャだけを結合します。
| Boolean |
output_all （オプション） |
このオプションは、すべての入力フィーチャを強制的に出力フィーチャとして書き出します。重なっていないフィーチャは、変更されずにそのまま出力に書き出されます。重なっているフィーチャは、結合されてから出力に書き出されます。
| Boolean |
コードのサンプル
次の Python ウィンドウ スクリプトは、イミディエイト モードで Union 3D（ユニオン 3D）関数を使用する方法を示しています。
import arcpy
from arcpy import env
arcpy.CheckOutExtension('3D')
env.workspace = 'C:/data'
arcpy.Union3D_3d('multipatch.shp', 'union_output.shp', 'GROUP_FIELD',
'DISABLE', 'ENABLE', 'UnionTable.dbf')
次の Python スクリプトは、スタンドアロン スクリプトで Union 3D（ユニオン 3D）関数を使用する方法を示しています。
'''****************************************************************************
Name: Union3D Example
Description: This script demonstrates how to use the
Union3D tool.
****************************************************************************'''
# Import system modules
import arcpy
import exceptions, sys, traceback
from arcpy import env
try:
arcpy.CheckOutExtension('3D')
# Set environment settings
env.workspace = 'C:/data'
# Set Local Variables
inMP = "multipatch.shp"
# Ensure output multipatch has a unique name
outMP = arcpy.CreateUniqueName("union_output.shp")
outTbl = arcpy.CreateUniqueName("UnionTable.dbf")
GroupField = "Type"
optimize = "DISABLE"
solids = "ENABLE"
#Execute Union3D
arcpy.ddd.Union3D(inMP, outMP, GroupField, optimize, solids, outTbl)
arcpy.CheckInExtension('3D')
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)