近接性による LAS ポイントの特定 (3D Analyst ツール)

サマリー

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

使用法

このツールは、指定された検索範囲内にある LAS ポイントの数を格納するフィールドで入力フィーチャを更新します。このツールで生成できるポイント数に制限はないため、極めて大きな検索距離の使用は避けるようにしてください。
LAS データセットのポイントは、分類コード、分類フラグ、リターン値、標高範囲でフィルターできます。 LAS データセットの レイヤープロパティ ダイアログボックスか、LAS データセットレイヤーの作成 ツールを使用して、ポイントフィルターを定義します。
シングルポイントジオメトリーを使用して出力ポイントフィーチャを生成する場合、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 ポイントを表す出力ポイントフィーチャのジオメトリーを指定します。 Multipoint—Multipoint features that will have multiple points in each row. Point—Single-point features that will have a unique row for each identified LAS point.	String
新しいクラスコード (オプション)	入力フィーチャの検索範囲内で検出されたポイントの再分類に使用されるクラスコード値。	Long
統計の計算 (オプション)	LAS データセットで参照されている `.las` ファイルの統計を計算するかどうかを指定します。統計を計算することで、`.las` ファイルごとの空間インデックスが提供され、解析と表示のパフォーマンスが向上します。また統計によって、分類コードやリターン情報などの LAS 属性の表示が `.las` ファイルに存在する値に制限されるので、フィルタリングとシンボルのエクスペリエンスも強化されます。オン—Statistics will be computed. This is the default. オフ—Statistics will not be computed.	Boolean
ピラミッドの更新 (オプション)	クラスコードが変更された後、LAS データセットのピラミッドを更新するかどうかを指定します。オン—The LAS dataset pyramid will be updated. This is the default. オフ—The LAS dataset pyramid will not be updated.	Boolean

派生した出力

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

arcpy.3d.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`—Multipoint features that will have multiple points in each row. `POINT`—Single-point features that will have a unique row for each identified LAS point.	String
class_code (オプション)	入力フィーチャの検索範囲内で検出されたポイントの再分類に使用されるクラスコード値。	Long
compute_stats (オプション)	LAS データセットで参照されている `.las` ファイルの統計を計算するかどうかを指定します。統計を計算することで、`.las` ファイルごとの空間インデックスが提供され、解析と表示のパフォーマンスが向上します。また統計によって、分類コードやリターン情報などの LAS 属性の表示が `.las` ファイルに存在する値に制限されるので、フィルタリングとシンボルのエクスペリエンスも強化されます。 `COMPUTE_STATS`—Statistics will be computed. This is the default. `NO_COMPUTE_STATS`—Statistics will not be computed.	Boolean
update_pyramid (オプション)	クラスコードが変更された後、LAS データセットのピラミッドを更新するかどうかを指定します。 `UPDATE_PYRAMID`—The LAS dataset pyramid will be updated. This is the default. `NO_UPDATE_PYRAMID`—The LAS dataset pyramid will not be updated.	Boolean

派生した出力

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

コードのサンプル

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

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

import arcpy
from arcpy import env

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

LocateLasPointsByProximity の例 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

# 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:
    # Run CreateLasDataset
    arcpy.management.CreateLasDataset(inLas, lasd, folder_recursion=recursion)
    # Run 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)
    # Run 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 が必要

近接性による LAS ポイントの特定 (3D Analyst ツール)

サマリー

使用法

パラメーター

派生した出力

環境

ライセンス情報

関連トピック