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

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

需要 3D Analyst 许可。

需要 Spatial Analyst 许可。

摘要

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

使用情况

• LAS 数据集设计用于使用文件版本 1.0-1.4 以 LAS 格式存储的点云数据。 还支持以压缩 ZLAS 格式存储的 LAS 文件。 可以通过任何创建新 LAS 文件的工具生成 ZLAS 文件，例如转换 LAS、提取 LAS、稀疏化 LAS 或切片 LAS。 此外，EzLAS Optimizer 独立应用程序还可用于将 .las 文件压缩为 .zlas 文件或者将其解压缩回 .las 文件。

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

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

参数

对话框

标注	说明	数据类型
输入 LAS 数据集	将要处理的 LAS 数据集。	LAS Dataset Layer
LAS 文件或文件夹 (可选)	输入，可以包括 .las 文件、.zlas 文件、LAS 数据集以及包含 .las 或 .zlas 数据的文件夹的任意组合。 当指定 LAS 数据集作为输入时，会将具有有效路径引用的所有 .las 和 .zlas 文件添加到输入 LAS 数据集。 在地理处理窗格中，还可以指定文件夹作为输入，具体方法如下：在 File Explorer 中选择文件夹，然后将其拖动到参数的输入框上。	LAS Dataset Layer; 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 数据集。 在地理处理窗格中，还可以指定文件夹作为输入，具体方法如下：在 File Explorer 中选择文件夹，然后将其拖动到参数的输入框上。	LAS Dataset Layer; 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])

环境

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