ユニオン 3D（Union 3D） (3D Analyst)
サマリ
入力フィーチャクラスから、重なり合う閉じたマルチパッチ フィーチャをマージします。
図
使用法
-
この解析には、クローズド マルチパッチ ジオメトリが必要です。[クローズド 3D（Is Closed 3D）] ツールを使用すると、マルチパッチ フィーチャクラスにクローズド フィーチャが含まれているかどうかを判定できます。また、[クローズド マルチパッチの作成（Enclose Multipatch）] ツールを使用すると、マルチパッチ フィーチャのギャップを除去できます。
重複する体積を含むマルチパッチ フィーチャは、フィーチャのシェルを構成する三角形とリングを交差させ、内部の重複部分を削除することによって、結合されます。このプロセスは、フィーチャクラスのすべてのマルチパッチ フィーチャが処理されるまで、繰り返し実行されます。
結合されるフィーチャを特定するには、グループ フィールドが使用できます。たとえば、複数のフィーチャが 1 つの建物を表している都市の建物部分をマルチパッチが表している場合などに使用します。グループ フィールドを使用することにより、データセットでツールを実行する回数を減らせるため、パフォーマンスを著しく向上させることができます。1 つのフィーチャをすべてのフィーチャと比較するのではなく、そのグループに属するフィーチャとだけ比較します。
最適化を有効にすると、ツールは、各フィーチャのバウンディング ボックスを解析することによって、自動的にフィーチャをグループに分けます。グループ フィールドを指定したら、最適化を無効にすることで、ツールのパフォーマンスが向上する可能性があります。目的の出力が、重なり合うすべてのフィーチャを単一のマルチパッチに結合することになっている場合は、グループ フィールドがないため、この場合も最適化を無効にできます。
-
出力フィーチャクラスに非常に大きく複雑なフィーチャが作成されると、表示パフォーマンスの低下を起こす可能性があるため、集約するフィーチャの数を決定する際には注意が必要です。
複数のマルチパッチ フィーチャが 1 つのエッジまたは頂点を共有している場合、作成されるフィーチャがシンプルでないため、作成されない可能性もあるという警告が表示されます。グループに体積または空間を共有しないマルチパッチが存在する場合にも、同じメッセージが表示されます。
-
オプションのテーブルを作成し、結合されたソース フィーチャの属性を特定して、結合された各出力を生成することができます。
注意:テーブルと出力フィーチャクラスとの関係を確立することで、ソース フィーチャに関連付けられている属性を検索できます。詳細については、「テーブル間の属性のリレート」をご参照ください。
-
このツールは、3D フィーチャの解析機能を備えた 3D セット演算子です。セット演算子の種類と、その使用方法については、「3D セット演算子の使用」をご参照ください。
構文
| パラメータ | 説明 | データ タイプ |
in_feature_class |
インターセクトおよび集約する閉じたマルチパッチ フィーチャ。 | Feature Layer |
group_field (オプション) |
グループ化するフィーチャを特定するのに使用するフィールド。 | Field |
out_feature_class |
集約されたフィーチャを格納する出力マルチパッチ フィーチャクラス。 | Feature Class |
out_table (オプション) |
入力フィーチャと集約されたフィーチャとの間のリレーションシップを表す多対 1 のテーブル。 | Table |
disable_optimization (オプション) |
最適化を自動実行させるか、または無効にするかを指定します。
| Boolean |
output_all (オプション) |
出力フィーチャクラスに、すべてのフィーチャを含めるか、または結合された重複フィーチャのみを含めるかを指定します。
| Boolean |
コードのサンプル
次のサンプルは、Python ウィンドウでこのツールを使用する方法を示しています。
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 スクリプトでこのツールを使用する方法を示しています。
'''****************************************************************************
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)