見通し線の構築 (Construct Sight Lines) (3D Analyst)—ArcMap

概要
図
使用法
構文
コードのサンプル
環境
ライセンス情報

概要

1 つまたは複数の観測点から見通し線を表すラインフィーチャを、ターゲットフィーチャクラス内のフィーチャに作成します。

図

使用法

見通し線は、[サンプリング距離] パラメーターで指定された値に基づいて、ターゲットとするラインおよびポリゴンの境界線からサンプリングされます。[サンプリング距離] の単位は、出力フィーチャクラスの X、Y 単位で指定します。
結合フィールドを使用して、特定の観測点の 1 つ以上の目標点を指定します。結合フィールドを使用しない場合、すべてのポイントがすべての目標点に接続されます。
高さのソースが観測点フィーチャとターゲットフィーチャの両方に指定されている場合、3D 出力が生成されます。観測点フィーチャとターゲットフィーチャの高さのソースはデフォルトでは、このリストで最初に見つかったフィールド名になります。
1. Shape.Z (Z が有効化されているフィーチャにのみ使用可能)
2. Spot
3. Z
4. Z_Value
5. Height
6. Elev
7. Elevation
8. Contour
適した高度フィールドが存在しない場合、デフォルトでキーワード「<なし>」が使用されて Z 値を持たないフィーチャが表示されます。
デフォルトのフィールド選択では、必要な高度フィールドの優先度が低い場合、必要なフィールドを明示的に指定する必要があります。同時に、高度フィールドは必要ないがフィーチャクラスにデフォルトの選択リストのフィールドの 1 つが含まれる場合は、キーワード「<なし>」を指定する必要があります。
次のフィールドが、見通し線を含む出力フィーチャクラスに追加されます。
- OID_OBSERV - 観測点の OID
- OID_TARGET - ターゲットフィーチャの OID
- DIST_ALONG - ターゲットフィーチャに沿った距離 (ターゲットフィーチャがラインまたはポリゴンの場合)
[方向の出力] パラメーターを有効にすると、出力された見通し線には、次の 2 つの属性フィールドが与えられます。
- AZIMUTH - 真北からの角度 (値が時計回りに増加する場合)
- VERT_ANGLE - 水平からの垂直角度 (90°が真上で -90°が真下の場合) 高度フィールドが指定されていない場合、垂直角は関係ありません。

構文

arcpy.ddd.ConstructSightLines(in_observer_points, in_target_features, out_line_feature_class, {observer_height_field}, {target_height_field}, {join_field}, {sample_distance}, {output_the_direction})

パラメーター	説明	データタイプ
in_observer_points	観測点を表す単一のポイントフィーチャマルチポイントフィーチャはサポートされていません。	Feature Layer
in_target_features	ターゲットフィーチャ (ポイント、マルチポイント、ライン、ポリゴン)	Feature Layer
out_line_feature_class	見通し線を含む出力フィーチャクラス	Feature Class
observer_height_field (オプション)	属性テーブルから取得された観測点の高さの値のソース [観測点の高度フィールド] のデフォルト値は、以下のリストのオプションの中から優先度順に設定されます。複数のフィールドが存在し、デフォルトのフィールド選択では必要な高度フィールドの優先度が低い場合、必要なフィールドを明示的に指定する必要があります。 <None> —結果として得られる見通し線フィーチャに、Z 値は割り当てられません。 Shape.Z Spot Z Z_Value Height Elev Elevation Contour	String
target_height_field (オプション)	目標点の高度フィールドです。 [目標点の高度フィールド] のデフォルト値は、以下のリストのオプションの中から優先度順に設定されます。複数のフィールドが存在し、デフォルトのフィールド選択では必要な高度フィールドの優先度が低い場合、必要なフィールドを明示的に指定する必要があります。 <None> —結果として得られる見通し線フィーチャに、Z 値は割り当てられません。 Shape.Z Spot Z Z_Value Height Elev Elevation Contour	String
join_field (オプション)	[フィールドの結合]は、観測点を特定の目標点に関連付けるために使用されます。 <None> —結果として得られる見通し線フィーチャに、Z 値は割り当てられません。	String
sample_distance (オプション)	ターゲットがラインまたはポリゴンフィーチャクラスのときのサンプル間の距離です。[サンプリング距離] の単位は、出力フィーチャクラスの XY 単位で解釈されます。	Double
output_the_direction (オプション)	出力見通し線に方向属性を追加します。方向を示すための 2 つのフィールド (AZIMUTH および VERT_ANGLE(垂直角)) が追加および適用されます。 NOT_OUTPUT_THE_DIRECTION — 出力見通し線に追加される方向属性はありません。これがデフォルトです。 OUTPUT_THE_DIRECTION — 方向を示すための 2 つのフィールド (AZIMUTH および VERT_ANGLE (垂直角)) が追加および適用されます。	Boolean

コードのサンプル

ConstructSightLines (見通し線の構築) の例 1 (Python ウィンドウ)

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

arcpy.CheckOutExtension('3D')
arcpy.env.workspace = 'C:/data'
arcpy.ConstructSightLines_3d('observer_pt.shp', 'target.shp', 'sightlines.shp', 
                             'BASEHEIGHT', 'TOP_HEIGHT', 'NAME', 1)

ConstructSightLines (見通し線の構築) の例 2 (スタンドアロンスクリプト)

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

'''*********************************************************************
Name: Sight Line Visibility of Parade Path
Description: This script demonstrates how to create a sight line feature class
             from a pair of observer and target points.
*********************************************************************'''
# Import system modules
import arcpy
import exceptions, sys, traceback
from arcpy import env

try:
    # Checking out 3D Analyst Extension:
    arcpy.CheckOutExtension('3D')

    # Set Local Variables:
    env.workspace = 'C:/data'

    # Setting up input and output variables:
    obs = "observer_pts.shp"
    tar = "parade_path.shp"
    sightlines = "output_sightlines.shp"
    height = "<None>"
    join_field = "#"
    sampling = 0.5
    direction = "OUTPUT_THE_DIRECTION"
    surface = 'elevation.tif'
    bldgs = 'buildings.shp'

    arcpy.AddMessage("Building sightlines...")
    arcpy.ddd.ConstructSightLines(obs, tar, sightlines, height, height, 
                                  join_field, sampling, direction)
    arcpy.ddd.LineOfSight(surface, sightlines, "Parade_LOS.shp", 
                          "Obstructions.shp", in_features=bldgs)
    
    arcpy.GetMessages(0)
    arcpy.CheckInExtension("3D")

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)

環境

ライセンス情報

Basic: 次のものが必要 3D Analyst
Standard: 次のものが必要 3D Analyst
Advanced: 次のものが必要 3D Analyst

概要

図

使用法

構文

コードのサンプル

ConstructSightLines (見通し線の構築) の例 1 (Python ウィンドウ)

ConstructSightLines (見通し線の構築) の例 2 (スタンドアロン スクリプト)

環境

ライセンス情報

関連トピック

ConstructSightLines (見通し線の構築) の例 2 (スタンドアロンスクリプト)