按邻域查找 LAS 点 (3D Analyst 工具)

汇总

用于标识已启用 z 值要素的三维邻域内的 LAS 点，并提供重新分类这些点的选项。

用法

该工具会使用包含位于指定搜索半径内的 LAS 点数的字段更新输入要素。该工具可生成任意数量的点，因此请考虑避免使用极大的搜索距离。
您可以按分类代码、分类标志、返回值和高程范围过滤 LAS 数据集的点。在 LAS 数据集的图层属性对话框中或使用 创建 LAS 数据集图层 工具定义点过滤器。
使用单点几何生成输出点要素时，将向该输出中添加名为 DIST3D 的字段（该输出将包含从点到最近输入要素的 3D 距离）。

参数

Dialog
Python

标注	说明	数据类型
输入 LAS 数据集	将要处理的 LAS 数据集。	LAS Dataset Layer
输入 3D 要素	将使用其邻域识别 LAS 点的 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 点、线、面或多面体要素。	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 值域, 自动提交

许可信息

基本: 需要 3D Analyst
标准: 需要 3D Analyst
高级: 需要 3D Analyst

按邻域查找 LAS 点 (3D Analyst 工具)

汇总

用法

参数

派生输出

环境

许可信息

相关主题