3D ラインをマルチパッチでインターセクト (Intersect 3D Line With Multipatch) (3D Analyst)

サマリー

3D ラインとマルチパッチ フィーチャのジオメトリの交差部分の数を返し、交差ポイントを表すオプションのフィーチャを出力するとともに、3D ラインを交差ポイントで分割します。

[3D ラインをマルチパッチでインターセクト (Intersect 3D Line With Multipatch)] の図

使用法

  • 交差数は、メッセージ ウィンドウに返され、それ以降の処理の前提条件を確立するモデルまたはスクリプトに使用できます。

  • このツールは、3D ユークリッド空間での交差ポイントを決定します。2D ライン フィーチャはこのツールでサポートされていませんが、高さの定義が属性フィールドに格納された 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 長さに等しくなります。
  • 元のラインの属性値は、出力ライン フィーチャクラスを使用することで、[属性を結合] パラメーターを介してオプションの出力フィーチャ内で参照できます。

パラメーター

ラベル説明データ タイプ
入力ライン フィーチャ

マルチパッチ フィーチャと交差するライン フィーチャ。

Feature Layer
入力マルチパッチ フィーチャ

ラインが交差するマルチパッチ フィーチャ。

Feature Layer
結合する属性
(オプション)

オプションの出力フィーチャに格納される入力ライン フィーチャ属性。

  • IDS_ONLY フィーチャの識別番号のみが格納されます。これがデフォルトです。
  • ALLすべての属性が格納されます。
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
(オプション)

オプションの出力フィーチャに格納される入力ライン フィーチャ属性。

  • IDS_ONLY フィーチャの識別番号のみが格納されます。これがデフォルトです。
  • ALLすべての属性が格納されます。
String
out_point_feature_class
(オプション)

3D ラインとマルチパッチ間の交差ポイントを表すオプションのフィーチャ。

Feature Class
out_line_feature_class
(オプション)

マルチパッチ フィーチャとの各交差ポイントで入力ラインを分割するオプションのライン フィーチャ。

Feature Class

派生した出力

名前説明データ タイプ
out_intersection_count

交差数。

Long

コードのサンプル

Intersect3DLineWithMultipatch (3D ラインをマルチパッチでインターセクト) の例 1 (Python ウィンドウ)

次のサンプルは、Python ウィンドウでこのツールを使用する方法を示しています。

arcpy.env.workspace = 'C:/data'
arcpy.Intersect3DLineWithMultiPatch_3d('inLine.shp', 'inMultipatch.shp', 
                                     'IDS_ONLY', 'outPts.shp', 'outLine.shp')
Intersect3DLineWithMultipatch (3D ラインをマルチパッチでインターセクト) の例 2 (スタンドアロン スクリプト)

次のサンプルは、スタンドアロン 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)

関連トピック