3D ラインとマルチパッチ フィーチャのジオメトリの交差部分の数を返し、交差ポイントを表すオプションのフィーチャを出力するとともに、3D ラインを交差ポイントで分割します。
![[3D ラインをマルチパッチでインターセクト (Intersect 3D Line With Multipatch)] の図](GUID-6B640EA8-3F8D-4620-9B9D-928DAB4EB846-web.png "[3D ラインをマルチパッチでインターセクト (Intersect 3D Line With Multipatch)] の図")
交差数は、メッセージ ウィンドウに返され、それ以降の処理の前提条件を確立するモデルまたはスクリプトに使用できます。
このツールは、3D ユークリッド空間での交差ポイントを決定します。2D ライン フィーチャはこのツールでサポートされていませんが、高さの定義が属性フィールドに格納された 2D ライン フィーチャは、[属性でフィーチャを 3D に変換 (Feature to 3D By Attribute)] を使用して、3D に変換できます。
オプションのポイント出力は、入力ラインとマルチパッチ フィーチャ間の交差ポイントを表し、次の属性を含みます。
オプションのライン出力は、交差ポイントで入力ライン フィーチャを分割し、次の属性を含みます。
ラインがマルチパッチと交差しない場合は、このマルチパッチは出力に直接コピーされ、FROM_MP_ID フィールドと TO_MP_ID フィールドには -1 が出力されます。
元のラインの属性値は、出力ライン フィーチャクラスを使用することで、[属性を結合] パラメーターを介してオプションの出力フィーチャ内で参照できます。
| ラベル | 説明 | データ タイプ |
入力ライン フィーチャ | マルチパッチ フィーチャと交差するライン フィーチャ。 | Feature Layer |
入力マルチパッチ フィーチャ | ラインが交差するマルチパッチ フィーチャ。 | Feature Layer |
結合する属性 (オプション) | オプションの出力フィーチャに格納される入力ライン フィーチャ属性。
| String |
出力ポイント (オプション) | 3D ラインとマルチパッチ間の交差ポイントを表すオプションのフィーチャ。 | Feature Class |
出力ライン (オプション) | マルチパッチ フィーチャとの各交差ポイントで入力ラインを分割するオプションのライン フィーチャ。 | Feature Class |
| ラベル | 説明 | データ タイプ |
| 交差数 | 交差数。 | Long |
arcpy.ddd.Intersect3DLineWithMultiPatch(in_line_features, in_multipatch_features, {join_attributes}, {out_point_feature_class}, {out_line_feature_class})| 名前 | 説明 | データ タイプ |
in_line_features | マルチパッチ フィーチャと交差するライン フィーチャ。 | Feature Layer |
in_multipatch_features | ラインが交差するマルチパッチ フィーチャ。 | Feature Layer |
join_attributes (オプション) | オプションの出力フィーチャに格納される入力ライン フィーチャ属性。
| String |
out_point_feature_class (オプション) | 3D ラインとマルチパッチ間の交差ポイントを表すオプションのフィーチャ。 | Feature Class |
out_line_feature_class (オプション) | マルチパッチ フィーチャとの各交差ポイントで入力ラインを分割するオプションのライン フィーチャ。 | Feature Class |
| 名前 | 説明 | データ タイプ |
| out_intersection_count | 交差数。 | Long |
次のサンプルは、Python ウィンドウでこのツールを使用する方法を示しています。
arcpy.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
# Set environment settings
arcpy.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)