近接性による LAS ポイントの特定 (Locate LAS Points By Proximity) (3D Analyst)—ArcGIS Pro

サマリー

Z 対応フィーチャの 3 次元の範囲内にある LAS ポイントと、これらのポイントを再分類するためのオプションを特定します。

使用法

このツールは、入力フィーチャの、指定した検索範囲内にある LAS ポイントの数が格納されるフィールドを更新します。このツールで生成できるポイント数には制限はないので、極端に大きすぎる検索距離を使用しないことも検討してください。
LAS データセットレイヤーにより、レイヤーのフィルター設定内の分類コード、分類フラグ、リターンの組み合わせを選択することで表示および処理される LAS ポイントを制限できます。フィルターは、[レイヤープロパティ] ダイアログボックスまたは [LAS データセットレイヤーの作成 (Make LAS Dataset Layer)] ツールで定義できます。
シングルポイントジオメトリを使用して出力ポイントフィーチャを生成する場合、DIST3D というフィールドが出力に追加されます。このフィールドには、ポイントから最も近い入力フィーチャへの 3D 距離が含まれます。

パラメーター

ラベル	説明	データタイプ
入力 LAS データセット	処理対象の LAS データセット。	LAS Dataset Layer
入力 3D フィーチャ	LAS ポイントの識別に使用される近接性を持つ、3D ポイントフィーチャ、3D ラインフィーチャ、3D ポリゴンフィーチャ、または 3D マルチパッチフィーチャ。	Feature Layer
検索範囲	LAS ポイントの存在が調べられる入力フィーチャの周囲の距離。これは、直線距離または入力フィーチャの属性テーブル内の数値フィールドで指定できます。フィールドまたは直線距離から得られた検索範囲の単位が [不明] と指定されている場合、入力フィーチャの XY 空間参照の距離単位が使用されます。	Linear Unit; Field
カウントフィールド	入力フィーチャの属性テーブルに追加され、各フィーチャに近接する LAS ポイントの数が設定されるフィールドの名前。デフォルトのフィールド名は COUNT です。	String
出力フィーチャクラス (オプション)	入力フィーチャから指定した距離の範囲内で検出された LAS ポイントを表すポイントフィーチャ。	Feature Class
出力ジオメトリタイプ (オプション)	入力フィーチャから指定した距離の範囲内で検出された LAS ポイントを表す出力ポイントフィーチャのジオメトリを指定します。マルチポイント—各行に複数のポイントを含むマルチポイントフィーチャ。ポイント—特定された LAS ポイントごとに一意の行を含むシングルポイントフィーチャ。	String
新しいクラスコード (オプション)	入力フィーチャの検索範囲内で検出されたポイントの再分類に使用されるクラスコード値。	Long
統計情報の計算 (オプション)	LAS データセットで参照されている .las ファイルの統計情報を計算するかどうかを指定します。統計情報を計算することで、.las ファイルごとの空間インデックスが提供され、解析と表示のパフォーマンスが向上します。また統計によって、分類コードやリターン情報などの LAS 属性の表示が *.las ファイルに存在する値に制限されるので、フィルタリングとシンボルのエクスペリエンスも強化されます。オン - 統計情報を計算します。これがデフォルトです。オフ - 統計情報を計算しません。	Boolean
ピラミッドの更新 (オプション)	クラスコードが変更された後に、LAS データセットのピラミッドを更新するかどうかを指定します。オン - LAS データセットのピラミッドを更新します。これがデフォルトです。オフ - LAS データセットのピラミッドを更新しません。	Boolean

派生した出力

ラベル	説明	データタイプ
更新された入力 LAS データセット	更新された LAS データセット。	LAS Dataset Layer
更新された入力 3D フィーチャ	更新された入力 3D フィーチャ。	Feature Layer

arcpy.ddd.LocateLasPointsByProximity(in_las_dataset, in_features, search_radius, count_field, {out_features}, {geometry}, {class_code}, {compute_stats}, {update_pyramid})

名前	説明	データタイプ
in_las_dataset	処理対象の LAS データセット。	LAS Dataset Layer
in_features	LAS ポイントの識別に使用される近接性を持つ、3D ポイントフィーチャ、3D ラインフィーチャ、3D ポリゴンフィーチャ、または 3D マルチパッチフィーチャ。	Feature Layer
search_radius	LAS ポイントの存在が調べられる入力フィーチャの周囲の距離。これは、直線距離または入力フィーチャの属性テーブル内の数値フィールドで指定できます。フィールドまたは直線距離から得られた検索範囲の単位が [不明] と指定されている場合、入力フィーチャの XY 空間参照の距離単位が使用されます。	Linear Unit; Field
count_field	入力フィーチャの属性テーブルに追加され、各フィーチャに近接する LAS ポイントの数が設定されるフィールドの名前。デフォルトのフィールド名は COUNT です。	String
out_features (オプション)	入力フィーチャから指定した距離の範囲内で検出された LAS ポイントを表すポイントフィーチャ。	Feature Class
geometry (オプション)	入力フィーチャから指定した距離の範囲内で検出された LAS ポイントを表す出力ポイントフィーチャのジオメトリを指定します。 MULTIPOINT—各行に複数のポイントを含むマルチポイントフィーチャ。 POINT—特定された LAS ポイントごとに一意の行を含むシングルポイントフィーチャ。	String
class_code (オプション)	入力フィーチャの検索範囲内で検出されたポイントの再分類に使用されるクラスコード値。	Long
compute_stats (オプション)	LAS データセットで参照されている .las ファイルの統計情報を計算するかどうかを指定します。統計情報を計算することで、.las ファイルごとの空間インデックスが提供され、解析と表示のパフォーマンスが向上します。また統計によって、分類コードやリターン情報などの LAS 属性の表示が *.las ファイルに存在する値に制限されるので、フィルタリングとシンボルのエクスペリエンスも強化されます。 COMPUTE_STATS—統計情報を計算します。これがデフォルトです。 NO_COMPUTE_STATS—統計情報を計算しません。	Boolean
update_pyramid (オプション)	クラスコードが変更された後に、LAS データセットのピラミッドを更新するかどうかを指定します。 UPDATE_PYRAMID—LAS データセットのピラミッドを更新します。これがデフォルトです。 NO_UPDATE_PYRAMID—LAS データセットのピラミッドを更新しません。	Boolean

派生した出力

名前	説明	データタイプ
out_las_dataset	更新された LAS データセット。	LAS Dataset Layer
derived_features	更新された入力 3D フィーチャ。	Feature Layer

コードのサンプル

LocateLasPointsByProximity (近接性による LAS ポイントの特定) の例 1 (Python ウィンドウ)

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

import arcpy
from arcpy import env

arcpy.CheckOutExtension('3D')
env.workspace = 'C:/data'
arcpy.LocateLasPointsByProximity_3d('lidar.lasd', 'powerlines.shp', 
                                    search_radius="10 Feet", 
                                    count_field="Near_Pts",
                                    out_features="located_pts.shp")

LocateLasPointsByProximity (近接性による LAS ポイントの特定) の例 2 (スタンドアロンスクリプト)

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

'''****************************************************************************
Name: Classify Noise Points
Description: Updates classification of version 1.0 LAS files to conform to
             the standardized class codes introduced in the 1.1 specifications.
             The code is designed for use as a script tool.
****************************************************************************'''
# Import system modules
import arcpy
import exceptions, sys, traceback

# Set Local Variables
inLas = arcpy.GetParameterAsText(0)
recursion = arcpy.GetParameterAsText(1)
lasd = arcpy.GetParameterAsText(2)
reclassList = arcpy.GetParameterAsText(3) #List of values '<oldCode> <newCode>'
calcStats = arcpy.GetParameter(4)

try:
    # Execute CreateLasDataset
    arcpy.management.CreateLasDataset(inLas, lasd, folder_recursion=recursion)
    # Execute Locate Outliers
    outlier_pts = 'in_memory/outliers'
    arcpy.ddd.LocateOutliers(lasd, out_feature_class=outlier_pts, 
                            apply_hard_limit='Apply_Hard_Limit', 
                            absolute_z_min=-15, absolute_z_max=680, 
                            apply_comparison_filter='Apply_Comparison_Filter',
                            z_tolerance=0, slope_tolerance=150, 
                            exceed_tolerance_ratio=0.5, outlier_cap=3000)
    # Execute ChangeLasClassCodes
    arcpy.ddd.LocateLasPointsByProximity(lasd, in_features=outlier_pts, 
                                         search_radius='0.5 Centimeters', 
                                         class_code=18)
    # Report messages
    arcpy.GetMessages(0)

except arcpy.ExecuteError:
    print(arcpy.GetMessages())

環境

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

特殊なケース

ライセンス情報

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

サマリー

使用法

パラメーター

派生した出力

派生した出力

コードのサンプル

環境

特殊なケース

ライセンス情報

関連トピック

このトピックの内容