3D ラインをマルチパッチでインターセクト（Intersect 3D Line With Multipatch） (3D Analyst)
サマリ
ラインとマルチパッチ フィーチャのジオメトリの交差部分の数を判定して返します。また、交差を表すポイント フィーチャと、そのポイントで切断される入力ラインを表すライン フィーチャを、出力フィーチャクラスに書き込むこともできます。
図
使用法
-
このツールでは、2D ライン フィーチャはサポートされていません。交差部分の計算は 3D ユークリッド空間の 3D フィーチャで実行されるため、Z 対応の 3D ライン フィーチャである必要があります。高さの定義を属性フィールドに格納する 2D ライン フィーチャは、[属性でフィーチャを 3D に変換（Feature to 3D By Attribute）] を使用して、3D に変換できます。
交差数は、メッセージ ウィンドウに整数の結果として返され、それ以降の処理の前提条件を確立するモデルまたはスクリプトに使用できます。
-
オプションのポイント出力は、入力ラインとマルチパッチ フィーチャ間の交差ポイントを表し、次の属性を含みます。
- LINE_OID - 交差の見つかった元のラインの OBJECTID
- MPATCH_OID - この位置でラインと交差したマルチパッチの OBJECTID
- DIST_3D - 交差の見つかった元のラインの 3D 距離
-
オプションのライン出力は、交差ポイントで入力ライン フィーチャを分割し、次の属性を含みます。
- LINE_OID - 新しいラインの取得元である元のラインの OBJECTID。
- FROM_MP_ID - 新しいラインの始点と交差するマルチパッチ フィーチャの OBJECTID。値が -1 の場合、ラインの始点が交差ポイントでないことを示します。
- TO_MP_ID - 新しいラインの終点と交差するマルチパッチの OBJECTID。値が -1 の場合、ラインの始点が交差ポイントでないことを示します。
注意:ラインがマルチパッチと交差しない場合、ラインは出力に直接コピーされ、FROM_MP_ID および TO_MP_ID フィールドの値が -1 になります。
- DIST_3D - 交差の見つかった元のライン（この新しいラインの始点となるライン）の 3D 距離。
- LENGTH_3D - この新しいラインの 3D 長さ。元のラインから取得した新しい各ラインの長さを合計した値は、元のラインの 3D 長さに等しくなります。
元のラインの属性値は、出力ライン フィーチャクラスを使用することで、[属性を結合] パラメータを介してオプションの出力フィーチャ内で参照できます。
このツールは、3D フィーチャの解析機能を備えた 3D セット演算子です。セット演算子の種類と、その使用方法については、「3D セット演算子の使用」をご参照ください。
構文
| パラメータ | 説明 | データ タイプ |
in_line_features |
マルチパッチ フィーチャと交差するライン フィーチャ。 | Feature Layer |
in_multipatch_features |
ラインが交差するマルチパッチ フィーチャ。 | Feature Layer |
join_attributes (オプション) |
入力ライン フィーチャの属性が出力フィーチャクラスに維持されるかどうかを定義します。
| String |
out_point_feature_class (オプション) |
3D ラインとマルチパッチ間の交差ポイントを表すオプションのフィーチャ。 | Feature Class |
out_line_feature_class (オプション) |
マルチパッチ フィーチャとの交差ポイントで入力 3D ラインを分割するオプションのライン フィーチャ。 | Feature Class |
コードのサンプル
次のサンプルは、Python ウィンドウでこのツールを使用する方法を示しています。
import arcpy
from arcpy import env
arcpy.CheckOutExtension('3D')
env.workspace = 'C:/data'
arcpy.Intersect3DLineWithMultiPatch_3d('inLine.shp', 'inMultipatch.shp',
'IDS_ONLY', 'outPts.shp', 'outLine.shp')
次のサンプルは、スタンドアロン Python スクリプトでこのツールを使用する方法を示しています。
'''****************************************************************************
Name: Intersect3DLineWithMultiPatch Example
Description: This script demonstrates how to
use the Intersect3DLine 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
inLineFC = 'sample.gdb/lines_3d'
inMP = 'sample.gdb/test_MP'
# Ensure a unique name is produced for output files
outPoint = arcpy.CreateUniqueName('OutPt_3DIntersect', 'sample.gdb')
outLine = arcpy.CreateUniqueName('OutLine_3DIntersect', 'sample.gdb')
# Execute Intersect 3D Line with Multipatch
arcpy.Intersect3DLineWithMultiPatch_3d(inLineFC, inMP, 'IDS_ONLY',
outPoint, outLine)
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)