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

サマリー

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

図

3D ラインをマルチパッチでインターセクトの例

使用法

交差数はメッセージウィンドウに返され、モデルやスクリプトで後続の操作の前提条件を設定するために使用できます。
このツールは、3D ユークリッド空間での交点を求めます。 2D ラインフィーチャはこのツールではサポートされていませんが、属性フィールドに高さの定義が格納されている 2D ラインフィーチャは、属性でフィーチャを 3D に変換 を使用して 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
結合する属性 (オプション)	オプションの出力フィーチャに格納される入力ラインフィーチャ属性。 Only Feature ID Numbers—Only feature identification numbers will be stored. This is the default. All Attributes—All attributes will be stored.	String
出力ポイント (オプション)	3D ラインとマルチパッチ間の交差ポイントを表すオプションのフィーチャ。	Feature Class
出力ライン (オプション)	マルチパッチフィーチャとの各交差ポイントで入力ラインを分割するオプションのラインフィーチャ。	Feature Class

派生した出力

ラベル	説明	データタイプ
交差数	交差数。	Long

arcpy.3d.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`—Only feature identification numbers will be stored. This is the default. `ALL`—All attributes will be stored.	String
out_point_feature_class (オプション)	3D ラインとマルチパッチ間の交差ポイントを表すオプションのフィーチャ。	Feature Class
out_line_feature_class (オプション)	マルチパッチフィーチャとの各交差ポイントで入力ラインを分割するオプションのラインフィーチャ。	Feature Class

派生した出力

名前	説明	データタイプ
out_intersection_count	交差数。	Long

コードのサンプル

Intersect3DLineWithMultipatch の例 1 (Python ウィンドウ)

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

arcpy.env.workspace = 'C:/data'
arcpy.ddd.Intersect3DLineWithMultiPatch('inLine.shp', 'inMultipatch.shp',
                                        'IDS_ONLY', 'outPts.shp', 'outLine.shp')

Intersect3DLineWithMultipatch の例 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')

# Run Intersect3DLinewithMultipatch
arcpy.ddd.Intersect3DLineWithMultiPatch(inLineFC, inMP, 'IDS_ONLY',
                                        outPoint, outLine)

環境

現在のワークスペース, 範囲, 出力座標系, 地理座標系変換, XY 座標精度, XY 許容値, Z 座標精度, Z 許容値, 出力データのコンフィグレーションキーワード, 自動コミット, 出力データの XY ドメイン, 出力データの Z ドメイン

ライセンス情報

Basic: 3D Analyst が必要
Standard: 3D Analyst が必要
Advanced: 3D Analyst が必要

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

サマリー

図

使用法

注意:

パラメーター

派生した出力

環境

ライセンス情報

関連トピック