最近接 3D (3D Analyst ツール)

サマリー

各入力フィーチャから、1 つ以上の近接フィーチャクラスにある最近接フィーチャまでの 3 次元距離を計算します。

使用法

すべての入力フィーチャは Z 値を持っている必要があり、すべてのジオメトリータイプがサポートされています。入力フィーチャを近接フィーチャとして指定し、同じフィーチャクラス内の最近隣フィーチャを特定することもできます。
次のフィールドを入力フィーチャの属性テーブルに追加できます。
- NEAR_FID—最近接フィーチャの FID。値 -1 は、指定された検索範囲内に一致するものが見つからなかったことを示します。
- NEAR_DIST—入力フィーチャ上の最近接ポイントと、最近接フィーチャ上の最近接ポイントとの間の 2D 距離 (水平距離)。
- NEAR_DIST3—入力フィーチャ上の最近接ポイントと、最近接フィーチャ上の最近接ポイントとの間の 3D 距離 (斜距離)。
- NEAR_DELTX—入力フィーチャ上の最近接ポイントから、最近接フィーチャ上の最近接ポイントまでの X 軸方向の距離。
- NEAR_DELTY—入力フィーチャ上の最近接ポイントから、最近接フィーチャ上の最近接ポイントまでの Y 軸方向の距離。
- NEAR_DELTZ—入力フィーチャ上の最近接ポイントから、最近接フィーチャ上の最近接ポイントまでの Z 軸方向の距離。
- NEAR_FROMX—最近接フィーチャに最も近い入力フィーチャ上のポイントの X 座標。
- NEAR_FROMY—最近接フィーチャに最も近い入力フィーチャ上のポイントの Y 座標。
- NEAR_FROMZ—最近接フィーチャに最も近い入力フィーチャ上のポイントの Z 座標。
- NEAR_X—最近接フィーチャ上の最近接ポイントの X 座標。
- NEAR_Y—最近接フィーチャ上の最近接ポイントの Y 座標。
- NEAR_Z—最近接フィーチャ上の最近接ポイントの Z 座標。
- NEAR_ANG_H—最近接ポイントへの数学座標の水平角 (度)。
- NEAR_ANG_V—最近接ポイントへの高度角 (度)。水平は 0、真上は 90、真下は -90 です。
- NEAR_FC—最近接フィーチャを含むフィーチャクラスのパス。このフィールドは、複数の近接フィーチャが指定された場合にのみ追加されます。
注意:

前述のフィールドがすでに存在する場合、それらの値が更新されます。

ラベル	説明	データタイプ
入力フィーチャ	フィーチャが最近接フィーチャに関する情報の属性を持つ入力フィーチャクラス。	Feature Layer
近接フィーチャ	入力フィーチャへの近接度が計算される 1 つ以上のフィーチャ。複数のフィーチャクラスが指定されると、最近隣フィーチャがどの近接フィーチャクラスに含まれていたかを特定する `NEAR_FC` という名前のフィールドが入力フィーチャクラスに追加されます。	Feature Layer
検索範囲 (オプション)	特定の入力からの最近接フィーチャを決定する最大距離。この値を指定しない場合、任意の距離で最近接フィーチャが決定されます。	Linear Unit
位置 (オプション)	入力の最近接ポイントおよび近接フィーチャの座標を入力の属性テーブルに追加するかどうかを決定します。オン—The coordinates are added to the input feature. オフ—The coordinates are not added to the input feature. This is the default.	Boolean
角度 (オプション)	入力フィーチャと最近接フィーチャ間の水平方向の演算角度および鉛直方向の角度を入力属性テーブルに追加するかどうかを決定します。オン—The horizontal arithmetic angle and vertical angle will be added to the `NEAR_ANG_H` and `NEAR_ANG_V` fields in the input's attribute table. オフ—The angles will not be added to the input's attribute table. This is the default.	Boolean
相対 (オプション)	入力フィーチャと最近接フィーチャ間の X、Y、Z 軸に沿った距離を入力属性テーブルに追加するかどうかを決定します。オン—Distances along the X, Y, and Z axes will be calculated in the `NEAR_DELTX`, `NEAR_DELTY`, and `NEAR_DELTZ` fields. オフ—No distances will be added to the input attribute table. This is the default.	Boolean

派生した出力

ラベル	説明	データタイプ
更新された入力フィーチャ	更新された入力フィーチャ。	Feature Layer

arcpy.3d.Near3D(in_features, near_features, {search_radius}, {location}, {angle}, {delta})

名前	説明	データタイプ
in_features	フィーチャが最近接フィーチャに関する情報の属性を持つ入力フィーチャクラス。	Feature Layer
near_features [near_features,...]	入力フィーチャへの近接度が計算される 1 つ以上のフィーチャ。複数のフィーチャクラスが指定されると、最近隣フィーチャがどの近接フィーチャクラスに含まれていたかを特定する `NEAR_FC` という名前のフィールドが入力フィーチャクラスに追加されます。	Feature Layer
search_radius (オプション)	特定の入力からの最近接フィーチャを決定する最大距離。この値を指定しない場合、任意の距離で最近接フィーチャが決定されます。	Linear Unit
location (オプション)	入力の最近接ポイントおよび近接フィーチャの座標を入力の属性テーブルに追加するかどうかを決定します。 `LOCATION`—The coordinates are added to the input feature. `NO_LOCATION`—The coordinates are not added to the input feature. This is the default.	Boolean
angle (オプション)	入力フィーチャと最近接フィーチャ間の水平方向の演算角度および鉛直方向の角度を入力属性テーブルに追加するかどうかを決定します。 `ANGLE`—The horizontal arithmetic angle and vertical angle will be added to the `NEAR_ANG_H` and `NEAR_ANG_V` fields in the input's attribute table. `NO_ANGLE`—The angles will not be added to the input's attribute table. This is the default.	Boolean
delta (オプション)	入力フィーチャと最近接フィーチャ間の X、Y、Z 軸に沿った距離を入力属性テーブルに追加するかどうかを決定します。 `DELTA`—Distances along the X, Y, and Z axes will be calculated in the `NEAR_DELTX`, `NEAR_DELTY`, and `NEAR_DELTZ` fields. `NO_DELTA`—No distances will be added to the input attribute table. This is the default.	Boolean

派生した出力

名前	説明	データタイプ
out_feature_class	更新された入力フィーチャ。	Feature Layer

コードのサンプル

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

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

arcpy.env.workspace = "C:/data"
arcpy.ddd.Near3D("points_3D.shp", "buildings_multipatch.shp", "30", "LOCATION", "ANGLE", "DELTA")

Near3D の例 2 (スタンドアロンスクリプト)

次のサンプルは、スタンドアロン Python スクリプトでこのツールを使用する方法を示しています:

'''****************************************************************************
Name: Near 3D Example
Description: This script demonstrates how to use
             the Near 3D tool to identify the nearest z-aware features
             that satisfy the results from a queried feature.
****************************************************************************'''
# Import system modules
import arcpy

# Set environment settings
arcpy.env.workspace = 'C:/data'
# Set Local Variables
inFC = 'homes.shp'
nearFC = 'radiotowers.shp'
# See the 'Building an SQL expression' topic for more information
# Query the field 'MATERIAL' for the string 'Reinforced Concrete'
SQL_Expression = "'"'MATERIAL'"' = 'Reinforced Concrete'"
# Run Make Feature Layer
arcpy.management.MakeFeatureLayer(nearFC, 'Near Layer', SQL_Expression)
result = arcpy.management.GetCount('Near Layer')
if int(result.getOutput(0)) == 0:
    arcpy.AddMessage('{0} has no features that satisfy the query: {1}'\
         .format(nearFC, SQL_Expression))
else:
    # Run Near3D
    arcpy.ddd.Near3D(inFC, 'nearLayer', '', 'LOCATION', 'ANGLE')

環境

現在のワークスペース, 範囲

ライセンス情報

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

最近接 3D (3D Analyst ツール)

サマリー

使用法

注意:

パラメーター

派生した出力

環境

ライセンス情報

関連トピック