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

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

需要 3D Analyst 许可。

需要 Spatial Analyst 许可。

摘要

将一个或多个 LAS 格式文件和表面约束要素添加到现有 LAS 数据集。

使用情况

• LAS 数据集提供了一种可视化、管理和分析存储在未压缩 LAS 文件 (*.las) 和压缩变体（*.zlas 和 *.laz）中的点云数据集合的方法。 LAS 数据集引用其所在的输入文件，并支持通过可优化渲染体验的单个访问点使用大量独立文件。 压缩文件通常使用的存储大小大约是未压缩文件的 30%，这使其成为管理大量数据和归档存储的合适替代方案。 您可以编辑未压缩 .las 文件和 .zlas 文件的类代码。 在考虑使用哪种文件格式时，请根据使用文件的应用程序来评估格式。

  了解有关 LAS 数据集支持的数据类型的详细信息

  ZLAS 文件可以使用任何创建 .las 文件的工具创建，包括：转换 LAS、提取 LAS、稀疏化 LAS、切片 LAS 和投影 LAS。 可以使用转换 LAS 工具创建 LAZ 文件。

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

• LAS 数据集的图层和目录属性中提供的类代码标注反映了 ASPRS LAS 1.4 规范中概述的类别名称。 该分类方案适用于航空激光雷达测量，包括以下内容：

  • 与预定义对象关联的类，例如，2 表示地面
  • 其值未定义但保留以供 ASPRS 后续使用的类
  • 可以分配给任何其他对象的类
  LAS 数据集图层的点过滤器、交互式编辑选项和默认符号系统标注反映了 LAS 格式规范的类代码标注。

  了解有关激光雷达点分类的详细信息。

• 系统会检查将添加到 LAS 数据集的每个 LAS 文件（*.las、*.zlas 或 .laz），以确定其文件结构是否符合 ASPRS LAS 格式规范。 未正确创建或损坏的文件将无法加载。 如果发生这种情况，请使用 Esri CheckLAS 应用程序来评估该文件。

• .las 文件的 ASPRS 规范要求文件具有空间参考信息。 如果此信息缺失或定义不正确，则文件将具有未知的空间参考，这将导致它在地图坐标系中渲染。 如果已知正确的空间参考，请使用定义投影工具或创建 LAS 数据集工具，并将为 LAS 文件创建 PRJ 设置为缺失空间参考的所有 LAS 文件。

  了解有关如何存储和修改 LAS 坐标系信息的详细信息

• LAS 数据集的图层和目录属性中提供的类代码标注反映了 ASPRS LAS 1.4 规范中概述的类别名称。 该分类方案适用于航空激光雷达测量，包括以下内容：

  • 与预定义对象关联的类，例如，2 表示地面
  • 其值未定义但保留以供 ASPRS 后续使用的类
  • 可以分配给任何其他对象的类
  LAS 数据集图层的点过滤器、交互式编辑选项和默认符号系统标注反映了 LAS 格式规范的类代码标注。

  了解有关激光雷达点分类的详细信息。

• 如果 LAS 标准适用于数据，但类代码不符合，则考虑修改类别名称以符合 ASPRS LAS 1.4 标准，以确保以一致的方式解释数据。 由于 LAS 格式 1.0 文件不需要任何分类标准，数据供应商可能已将分类代码应用于与最新 LAS 格式中引入的标准不匹配的对象。 如果数据中的类代码值与 LAS 标准不一致，请使用更改 LAS 类代码工具将该值与最新的 ASPRS 分类方案调整为保持一致。

参数

对话框

标注	说明	数据类型
输入 LAS 数据集	将要处理的 LAS 数据集。	LAS Dataset Layer
LAS 文件或文件夹 (可选)	要添加到输入 LAS 数据集的 LAS 格式文件(.las、.zlas 和 .laz)。 可以指定一个文件夹以在目录中添加所有支持的文件。 同样，可以提供另一个 LAS 数据集以添加其所有文件和有效路径。 在地理处理窗格中，可将文件夹指定为输入，具体方法如下：在 File Explorer 中选择文件夹，然后将其拖动到参数的输入框中。	LAS Dataset Layer; Folder; File
包括子文件夹 (可选)	指定是否将位于输入文件夹子目录中的 LAS 格式文件（.las、.zlas 和 .laz）添加到 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 数据集的 LAS 格式文件(.las、.zlas 和 .laz)。 可以指定一个文件夹以在目录中添加所有支持的文件。 同样，可以提供另一个 LAS 数据集以添加其所有文件和有效路径。 在地理处理窗格中，可将文件夹指定为输入，具体方法如下：在 File Explorer 中选择文件夹，然后将其拖动到参数的输入框中。	LAS Dataset Layer; Folder; File
folder_recursion (可选)	指定是否将位于输入文件夹子目录中的 LAS 格式文件（.las、.zlas 和 .laz）添加到 LAS 数据集中。 NO_RECURSION—仅位于输入文件夹中的 LAS 格式文件会添加到 LAS 数据集。 这是默认设置。 RECURSION—位于输入文件夹子目录中的所有 LAS 格式文件都将被添加到 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 - 定义如何将要素几何加入到表面的三角网中的表面要素类型。 具有硬或软标识的选项表示要素边是否表示坡度的明显中断或平缓变化。 anchorpoints - 不会被细化掉的高程点。 此选项仅可用于单点要素几何。 hardline 或 softline - 强制高度值的隔断线。 hardclip 或 softclip - 定义 LAS 数据集边界的面数据集。 harderase 或 softerase - 定义 LAS 数据集中的孔的面数据集。 hardreplace 或 softreplace - 定义恒定高度区域的面数据集。	Value Table

派生输出

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

代码示例

AddFilesToLasDataset 示例 1 (Python 窗口)

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

import arcpy
from arcpy import env

env.workspace = "C:/data"
arcpy.management.AddFilesToLasDataset("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: 是