見通し (Line Of Sight) (3D Analyst)—ArcGIS Pro

サマリー

ファンクションサーフェスおよびオプションのマルチパッチ上の見通しの可視性を判断します。

図

使用法

観測点と目標点の定義には、入力ラインの端点のみが使用されます。見通し線は、可視性を判断する対象の観測点と目標点を表す 2 つの頂点で構成される直線である必要があります。
観測点がポイントフィーチャで特定され、可視性のターゲットが他のフィーチャクラスにある場合、見通し線の構築 (Construct Sight Lines) ツールを使用して見通し線を作成することを検討してください。
出力線は、入力見通し線の表示可能な部分と表示不可能な部分の境界上で分割されます。サーフェスのみを使用して見通し線の可視性を判断する場合、出力線はサーフェスの断面に従います。見通しを計算する際にマルチパッチフィーチャが提供される場合、出力線は、入力見通し線の軌道に従います。
出力ラインフィーチャの属性テーブルには、以下のフィールドが含まれています。
- SourceOID - 見通しの計算で使用されるラインフィーチャの一意の ID。
- VisCode - ラインに沿った見通し。値が 1 の場合は可視であることを示し、値が 2 の場合は不可視であることを示します。このフィールドは、出力ジオメトリがラインの場合にのみ存在します。
- TarIsVis - ラインに沿った目標点の見通し。値が 1 の場合は可視であることを示し、値が 0 の場合は不可視であることを示します。このフィールドは、出力ジオメトリがラインの場合にのみ存在します。
- OBSTR_MPID - 見通しを妨げるマルチパッチの一意の ID。見通しを妨げるマルチパッチがない場合、フィールドの値は -1 または -9999 の値になります。目標点がサーフェスによって妨げられる場合は -1 になります。目標点が可視である場合は -9999 になります。

パラメーター

ラベル	説明	データタイプ
入力サーフェス	可視性を判断するために使用する 3D メッシュシーンレイヤー、LAS データセット、ラスター、TIN、またはテレインサーフェス。	TIN Layer; Raster Layer; Mosaic Layer; Terrain Layer; LAS Dataset Layer; Scene Layer; File
入力ラインフィーチャ	最初の頂点が観測点を定義し、最後の頂点が目標点を示すラインフィーチャ。観測点と目標点の高さは 3D フィーチャの Z 値から取得され、2D フィーチャで使用できるようにサーフェスから内挿されます。また、2D ラインの標高に値が 1 のデフォルトのオフセットが追加されてポイントがサーフェスより上に持ち上げられます。このフィーチャに OffsetA フィールドがある場合は、観測点の高さにその値が追加されます。OffsetB フィールドがある場合は、目標点の高さにその値が追加されます。	Feature Layer
出力フィーチャクラス	見通しが決定された出力ラインフィーチャクラス。2 つの属性フィールドが作成されます。VisCode フィールドはラインに沿った見通しを示しており、1 は可視、2 は不可視です。TarIsVis フィールドは目標点の見通しを示しており、0 は不可視、1 は可視です。	Feature Class
出力障害ポイントフィーチャクラス (オプション)	観測点から目標点までの見通し線における最初の障害の位置を示すオプションのポイントフィーチャクラス。	Feature Class
曲率の使用 (オプション)	見通し解析に対して地表の曲率を考慮に入れるかどうかを指定します。このパラメーターを有効にするためには、サーフェスの空間参照を定義して、座標値を投影し、Z 単位を定義する必要があります。オフ - 地球の曲率を考慮しません。これがデフォルトです。オン - 地球の曲率を考慮します。	Boolean
屈折率の使用 (オプション)	ファンクションサーフェスからの見通しを生成するときに、大気差を考慮するかどうかを指定します。マルチパッチフィーチャを使用している場合、このパラメーターは、適用されません。オフ - 大気の屈折を考慮しません。これがデフォルトです。オン - 大気の屈折を考慮します。	Boolean
屈折率 (オプション)	屈折率に使用する値。デフォルト値は 0.13 です。	Double
ピラミッドレベル解像度 (オプション)	使用されるテレインピラミッドレベルの Z 許容値またはウィンドウサイズの解像度。デフォルト値は 0 (最大解像度) です。	Double
入力フィーチャ (オプション)	建物など、障害物となるその他のエレメントを定義できるマルチパッチフィーチャ。屈折オプションはこの入力には影響しません。	Feature Layer

arcpy.ddd.LineOfSight(in_surface, in_line_feature_class, out_los_feature_class, {out_obstruction_feature_class}, {use_curvature}, {use_refraction}, {refraction_factor}, {pyramid_level_resolution}, {in_features})

名前	説明	データタイプ
in_surface	可視性を判断するために使用する 3D メッシュシーンレイヤー、LAS データセット、ラスター、TIN、またはテレインサーフェス。	TIN Layer; Raster Layer; Mosaic Layer; Terrain Layer; LAS Dataset Layer; Scene Layer; File
in_line_feature_class	最初の頂点が観測点を定義し、最後の頂点が目標点を示すラインフィーチャ。観測点と目標点の高さは 3D フィーチャの Z 値から取得され、2D フィーチャで使用できるようにサーフェスから内挿されます。また、2D ラインの標高に値が 1 のデフォルトのオフセットが追加されてポイントがサーフェスより上に持ち上げられます。このフィーチャに OffsetA フィールドがある場合は、観測点の高さにその値が追加されます。OffsetB フィールドがある場合は、目標点の高さにその値が追加されます。	Feature Layer
out_los_feature_class	見通しが決定された出力ラインフィーチャクラス。2 つの属性フィールドが作成されます。VisCode フィールドはラインに沿った見通しを示しており、1 は可視、2 は不可視です。TarIsVis フィールドは目標点の見通しを示しており、0 は不可視、1 は可視です。	Feature Class
out_obstruction_feature_class (オプション)	観測点から目標点までの見通し線における最初の障害の位置を示すオプションのポイントフィーチャクラス。	Feature Class
use_curvature (オプション)	見通し解析に対して地表の曲率を考慮に入れるかどうかを指定します。このパラメーターを有効にするためには、サーフェスの空間参照を定義して、座標値を投影し、Z 単位を定義する必要があります。 CURVATURE—地表の曲率が考慮されます。 NO_CURVATURE—地表の曲率は考慮されません。これがデフォルトです。	Boolean
use_refraction (オプション)	ファンクションサーフェスからの見通しを生成するときに、大気差を考慮するかどうかを指定します。マルチパッチフィーチャを使用している場合、このパラメーターは、適用されません。 REFRACTION—大気差が考慮されます。 NO_REFRACTION—大気差は考慮されません。これがデフォルトです。	Boolean
refraction_factor (オプション)	屈折率に使用する値。デフォルト値は 0.13 です。	Double
pyramid_level_resolution (オプション)	使用されるテレインピラミッドレベルの Z 許容値またはウィンドウサイズの解像度。デフォルト値は 0 (最大解像度) です。	Double
in_features (オプション)	建物など、障害物となるその他のエレメントを定義できるマルチパッチフィーチャ。屈折オプションはこの入力には影響しません。	Feature Layer

コードのサンプル

LineOfSight (見通し) の例 1 (Python ウィンドウ)

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

arcpy.env.workspace = "C:/data"
arcpy.ddd.LineOfSight("tin", "line.shp", "los.shp", "buldings_multipatch.shp", 
                    "obstruction.shp")

LineOfSight (見通し) の例 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

# Set Local Variables:
arcpy.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.ddd.ConstructSightLines(obs, tar, sightlines, height, height,
                              join_field, sampling, direction)
arcpy.ddd.LineOfSight(surface, sightlines, "Parade_LOS.shp",
                      "Obstructions.shp", in_features=bldgs)

環境

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

ライセンス情報

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

サマリー

図

使用法

パラメーター

コードのサンプル

環境

ライセンス情報

関連トピック

このトピックの内容