将文件添加到 LAS 数据集 (数据管理)

在 Standard 或 Advanced 许可等级下可用。

需要 3D Analyst 许可。

需要 Spatial Analyst 许可。

摘要

将一个或多个 LAS 文件和表面约束要素的引用添加到 LAS 数据集。

使用情况

• LAS 数据集旨在配合 LAS 或 ZLAS 格式的激光雷达数据使用。 支持的 LAS 格式文件版本为 1.0 - 1.4。 EzLAS Optimizer 是一个独立的雷达激光应用程序，可用于生成 .zlas 文件或将它们转换回 LAS 格式。

• 表面约束要素可用于强化 LAS 数据集中要素衍生的表示表面特征的高程值。

• ArcGIS 使用美国摄影测量及遥感协会 (ASPRS) 定义的 LAS 分类方案。 了解有关激光雷达点分类的详细信息

参数

对话框

标注	说明	数据类型
输入 LAS 数据集	待处理的 LAS 数据集。	LAS Dataset Layer
LAS 文件或文件夹 (可选)	输入，可以包括 .las 文件、.zlas 文件、LAS 数据集以及包含 .las 或 .zlas 数据的文件夹的任意组合。 当指定 LAS 数据集作为输入时，会将具有有效路径引用的所有 .las 和 .zlas 文件添加到输入 LAS 数据集。 在“工具”对话框中，可将文件夹指定为输入，具体方法如下：在 Windows 资源管理器中选择文件夹，然后将其拖动到参数的输入框上。	LAS Dataset; Folder; File
包括子文件夹 (可选)	指定 LAS 数据集是否引用位于输入文件夹子目录中的 .las 文件。 未选中 - 仅位于输入文件夹中的 .las 文件会添加到 LAS 数据集。 这是默认设置。 选中 - 位于输入文件夹子目录中的所有 .las 文件都将被添加到 LAS 数据集。	Boolean
表面约束 (可选)	将构成由 LAS 数据集生成的三角化网格面定义的要素。 输入要素 - 其几何将整合到 LAS 数据集的三角化网格面的要素。 高度字段 - 通过选择 Shape.Z，可以从要素属性表或几何中的任何数值字段获取要素的高程源。 如果无需高度，则指定关键字 <None> 来创建 z-less 要素，其高程由表面内插得到。 类型 - 定义由 LAS 数据集生成的三角化网格面中的要素角色。 具有硬或软标识的选项表示要素边是否表示坡度的明显中断或平缓变化。 表面要素类型 - 定义如何将要素几何加入到表面的三角网中的表面要素类型。 具有硬或软标识的选项表示要素边是否表示坡度的明显中断或平缓变化。 锚点 - 不会被细化掉的高程点。 此选项仅可用于单点要素几何。 硬断线或软断线 - 强制高度值的隔断线。 硬裁剪或软裁剪 - 定义 LAS 数据集边界的面数据集。 硬擦除或软擦除 - 定义 LAS 数据集中的孔的面数据集。 硬替换或软替换 - 定义高度恒定的区域的面数据集。	Value Table

派生输出

标注	说明	数据类型
更新后的输入 LAS 数据集	更新后的 LAS 数据集。	LAS Dataset Layer

Python

arcpy.management.AddFilesToLasDataset(in_las_dataset, {in_files}, {folder_recursion}, {in_surface_constraints})

名称	说明	数据类型
in_las_dataset	待处理的 LAS 数据集。	LAS Dataset Layer
in_files [in_files,...] (可选)	输入，可以包括 .las 文件、.zlas 文件、LAS 数据集以及包含 .las 或 .zlas 数据的文件夹的任意组合。 当指定 LAS 数据集作为输入时，会将具有有效路径引用的所有 .las 和 .zlas 文件添加到输入 LAS 数据集。 在“工具”对话框中，可将文件夹指定为输入，具体方法如下：在 Windows 资源管理器中选择文件夹，然后将其拖动到参数的输入框上。	LAS Dataset; Folder; File
folder_recursion (可选)	指定位于输入文件夹子目录中的激光雷达数据是否将添加到 LAS 数据集。 NO_RECURSION—未选中 - 仅位于输入文件夹中的激光雷达文件会添加到 LAS 数据集。 这是默认设置。 RECURSION—位于输入文件夹子目录中的所有激光雷达文件都将被添加到 LAS 数据集。	Boolean
in_surface_constraints [[in_feature_class, height_field, SF_type],...] (可选)	生成三角化网格面时，LAS 数据集将引用的要素。 每个要素都必须定义以下属性： in_feature_class - LAS 数据集将引用的要素。 height_field - 要素属性表中可用于定义高度源的任何数值字段。 如果要素几何包含 Z 值，则可以通过指定 Shape.Z 进行选择。 如果无需高度，则指定关键字 <None> 来创建 z-less 要素，其高程由表面内插得到。 SF_type - 定义如何将要素几何加入到表面的三角网中的表面要素类型。 具有硬或软标识的选项表示要素边是否表示坡度的明显中断或平缓变化。 锚点 - 不会被细化掉的高程点。 此选项仅可用于单点要素几何。 硬断线或软断线 - 强制高度值的隔断线。 硬裁剪或软裁剪 - 定义 LAS 数据集边界的面数据集。 硬擦除或软擦除 - 定义 LAS 数据集中的孔的面数据集。 硬替换或软替换 - 定义高度恒定的区域的面数据集。	Value Table

派生输出

名称	说明	数据类型
derived_las_dataset	更新后的 LAS 数据集。	LAS Dataset Layer

代码示例

AddFilesToLasDataset 示例 1（Python 窗口）

下面的示例演示了如何在 Python 窗口中使用此工具。

import arcpy
from arcpy import env

env.workspace = "C:/data"
arcpy.AddFilesToLasDataset_management("test.lasd", 
                                      ["LA_N", "LA_S/LA_5S4E.las"],
                                      "RECURSION", 
                                      ["boundary.shp <None> Soft_Clip",
                                       "breakline.shp Shape.Z Hard_Line"])

AddFilesToLasDataset 示例 2（独立脚本）

下面的示例演示了如何在独立 Python 脚本中使用此工具。

'''*********************************************************************
Name: Modify Files in LAS Dataset& Calculate Stats for LASD
Description: Adds files & surface constraints to a LAS dataset, then
             calculates statistics and generates report.
*********************************************************************'''
# Import system modules
import arcpy

try:
    # Script variables
    arcpy.env.workspace = 'C:/data'
    lasd = 'sample.lasd'
    oldLas = ['2006', '2007/file2.las']
    newLas = ['2007_updates_1', '2007_updates_2']
    oldSurfaceConstraints = ['boundary.shp', 'streams.shp']
    newSurfaceConstraints = [['sample.gdb/boundary', '<None>',
                              'Soft_Clip']
                             ['sample.gdb/streams', 'Shape.Z',
                              'Hard_Line']]
    arcpy.management.RemoveFilesFromLasDataset(lasd, oldLas,
                                               oldSurfaceConstraints)
    arcpy.management.AddFilesToLasDataset(lasd, newLas, 'RECURSION',
                                          newSurfaceConstraints)
    arcpy.management.LasDatasetStatistics(lasd, "UPDATED_FILES",
                                          "lasd_stats.txt",
                                          "LAS_FILE", "DECIMAL_POINT",
                                          "SPACE", "LAS_summary.txt")
except arcpy.ExecuteError:
    print(arcpy.GetMessages())
except Exception as err:
    print(err.args[0])

环境

当前工作空间, 临时工作空间

许可信息

• Basic: 需要 3D Analyst 或 Spatial Analyst
• Standard: 是
• Advanced: 是